Boodler uses the standard Python distutils system for building and installation.
First, download and unpack the source code from the Boodler web site.
Boodler is written in Python; you must have a Python interpreter installed on your system in order to run it. (Python version 2.3.5 or later is recommended. No, it doesn't work in Python 3.)
Boodler can generate audio output in any of several forms, each of which is defined by a driver module:
file-- write file containing raw sample output
stdout-- write raw sample output to stdout
oss-- Open Sound System
esd-- Enlightened Sound Daemon
alsa-- Advanced Linux Sound Architecture
macosx-- MacOSX CoreAudio
vorbis-- write Ogg Vorbis file
shout-- Shoutcast or Icecast source
lame-- write MP3 file with LAME encoder
Boodler will compile all of these drivers that it can find libraries for. If you have a Mac, CoreAudio is available if you have the Mac Developer Tools installed. On Linux, one of OSS, ESD, or ALSA is likely to be available.
If you list the source directory, you will see the following arrangement:
Type python setup.py build.
This tries to figure out the configuration of your system, and compiles the Boodler modules which can be compiled.
Type sudo python setup.py install.
This installs Boodler in the system's Python directory. The
sudo command will ask you for your password, which the
setup script needs to write to a system directory. If you want to
install to a different directory, you could instead type:
python setup.py install --prefix
Try this command:
You should hear a quick melody of test tones -- first alternating between left and right channels, and then playing in both.
You can now begin using Boodler.
/usr/local/bin/boodler, or (on the Mac)
boodler --list-driversto see a list, and then try adding
-o driverto your Boodler command line.
boodle.cboodlemodule was unable to open the sound device. The first line of the error message will have a more specific explanation.
/dev/dspis not found.
--deviceargument to indicate the correct location:
boodler --device /dev/whatever --testsound
python configure.py --integerconfiguration option. This reduces the number of floating-point operations, at the cost of less accurate volume fading.
--define buffercount=countoption. The default is 6; increasing it to 12 or 16 should help:
boodler --define buffercount=12 --testsound
alsamixer) to reduce the "PCM" component of your sound driver. You can compensate by turning up the "Master" component, or just turning up your speakers.
--masterargument to Boodler, giving it a master mixing volume less than the default of 0.5. Again, you can compensate with a mixer application or by turning up your speakers.
Return to Boodler docs index