| Minim is an audio library that uses the
JavaSound API
, a bit of Tritonus, and Javazoom's
MP3SPI to
provide an easy to use audio library for people developing in the
Processing environment. The philosophy behind the API is to make
integrating audio into your sketches as simple as possible while still
providing a reasonable amount of flexibility for more advanced users.
There are no callbacks and you do not ever need to directly manipulate
sample arrays, all of the dirty work is handled for you. The download
comes in two flavors: (1) just the jar files needed to use Minim and
(2) a full distribution that includes the javadocs, examples, and
source code. Minim is licensed under the
GNU
Lesser General Public License (LGPL), a copy of which is included with
both distributions. Users of Minim 1.1 should peruse the
Javadocs to
see what's changed (hint: not much has changed, but there are a couple
of nice new things).
Download:
Minim
2.0.2 full distro |
Minim
2.0.2 library only
Minim 2.1.0 Beta
The next version of Minim is currently available as a Beta build.
The big new feature is a music programming framework built around the
concept of a unit generator (UGen). This framework makes it possible to
intuitively create synthesis chains and schedule notes to be played
with these chains. You can read about the framework beginning in the
Minim Manual at the
Music
Programming Intro section. You can also peruse the Javadocs for the
Beta build online at
http://code.compartmental.net/minim-beta/javadoc/.
The package ddf.minim.ugens contains all of the new music programming
classes.
Download:
Minim
2.1.0 BETA (new UGen Framework)
Installation
To install either distribution, unzip the file into the
libraries folder in your sketchbook. Create this
directory if it doesn't exist. The zip should extract a directory named
minim. You will then need to remove the version of
Minim that is included with Processing.
On OSX: Find your Processing.app and right click,
choose "Show Package Contents". Then dig down to
Contents/Resources/Java/modes/java/libraries and delete the minim
folder in there.
On Windows: From the directory that contains
Processing.exe, dig down to modes/java/libraries and delete the minim
folder there. Finally,
restart Processing. Here are some of the features of
Minim:
- AudioPlayer: Mono and Stereo playback of WAV, AIFF, AU, SND,
and MP3 files.
- AudioMetaData: An object filled with metadata about a file,
such as ID3 tags.
- AudioRecorder: Mono and Stereo audio recording either
buffered or direct to disk.
- AudioInput: Mono and Stereo input monitoring.
- AudioOutput: Mono and Stereo sound synthesis.
- AudioSignal: A simple interface for writing your own sound
synthesis classes.
- Comes with all the standard waveforms, a pink noise generator
and a white noise generator. Additionally, you can extend the
Oscillator class for easy implementation of your own periodic
waveform.
- AudioEffect: A simple interface for writing your own audio
effects.
- Comes with low pass, high pass, band pass, and notch filters.
Additionally, you can extend the IIRFilter class for easy
implementation of your own IIR filters.
- Easy to attach signals and effects to AudioInputs and
AudioOutputs. All the mixing and processing is taken care of for you.
- Provides an FFT class for doing spectrum analysis.
- Provides a BeatDetect class for doing beat detection.
Planned Features:
- More AudioEffects like reverb, delay, phasing, ring
modulation, and bit crushing.
- Better filters using frequency domain filtering techniques.
To start using Minim, you can take a look at the
Quickstart
Guide or dive right into the
Javadocs. If
you have any questions about using the library you can
post
on the Processing forum or
send me a
private message there. If you find bugs, please report them on the
Github issues page.
If you'd like to contribute to the development of Minim, simply
fork the project on Github
and send pull requests when you've got code you'd like us to consider
for inclusion in the library. Enjoy!
|