live-beatbox/README.textile

h1. "Beatbox beta":http://github.com/rfwatson/live-beatbox

!http://rfwatson.github.com/images/beatbox.png!


Experimental drum machine which uses vocalization to select synthetic drum hits which best match beat-boxed sound.

Currently uses a combination of MFCC, SpectralCentroid and ZeroCrossing measurements to analyze and match the timbre of the sounds.

In super-alpha-beta state! It may or may not work on your setup.

h2. Requirements

* "SuperCollider":http://supercollider.sourceforge.net

* Some sort of external microphone and audio interface. I use an Edirol FA101 when building this. I haven't got it working well with the Mac's internal sound

* OSX - unless you want to make the GUI stuff cross-platform.

h2. Keyboard shortcuts

* @F1@
Record mode
* @F2@
Preview recorded sound
* @F3@
Jamming mode
* @Space@
Start/stop sequencer
* @Return@
Add hit to seq (while playing)
* @Backsp.@
Remove hit (while playing)
* @Up/Down@
Select channel
* @Left/Rt@
Crossfader control

h2. TODO

* Add analysis of amplitude envelope, only uses timbral analysis at the moment which while quite good it needs amp.env. comparison to be really intuitive
* Add ability to scan and add samples via GUI, from any location
* Improve doc
* Lots more...

h2. Contact me

Via "Github":http://github.com/rfwatson

h2. Licence

bq. *Released under the GNU General Public License.*
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with 
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA
try to sort out README 2009-01-04 15:15:17 +00:00			`h1. "Beatbox beta":http://github.com/rfwatson/live-beatbox`
added everything 2009-01-04 14:52:21 +00:00
			`!http://rfwatson.github.com/images/beatbox.png!`


			`Experimental drum machine which uses vocalization to select synthetic drum hits which best match beat-boxed sound.`

			`Currently uses a combination of MFCC, SpectralCentroid and ZeroCrossing measurements to analyze and match the timbre of the sounds.`

			`In super-alpha-beta state! It may or may not work on your setup.`

			`h2. Requirements`

			`* "SuperCollider":http://supercollider.sourceforge.net`

			`* Some sort of external microphone and audio interface. I use an Edirol FA101 when building this. I haven't got it working well with the Mac's internal sound`

			`* OSX - unless you want to make the GUI stuff cross-platform.`

			`h2. Keyboard shortcuts`

README again 2009-01-04 15:16:48 +00:00			`* @F1@`
			`Record mode`
			`* @F2@`
			`Preview recorded sound`
			`* @F3@`
			`Jamming mode`
			`* @Space@`
			`Start/stop sequencer`
			`* @Return@`
			`Add hit to seq (while playing)`
			`* @Backsp.@`
			`Remove hit (while playing)`
			`* @Up/Down@`
			`Select channel`
			`* @Left/Rt@`
			`Crossfader control`
added everything 2009-01-04 14:52:21 +00:00
			`h2. TODO`

			`* Add analysis of amplitude envelope, only uses timbral analysis at the moment which while quite good it needs amp.env. comparison to be really intuitive`
			`* Add ability to scan and add samples via GUI, from any location`
			`* Improve doc`
			`* Lots more...`

			`h2. Contact me`

			`Via "Github":http://github.com/rfwatson`

add licence 2009-01-04 15:21:13 +00:00			`h2. Licence`

			`bq. Released under the GNU General Public License.`
			`This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.`
			`This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.`
			`You should have received a copy of the GNU General Public License along with`
			`this program; if not, write to the Free Software Foundation, Inc., 59 Temple`
			`Place, Suite 330, Boston, MA 02111-1307 USA`