live-beatbox/README.textile

57 lines
2.0 KiB
Plaintext

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