Minim

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.

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.
  • FFT: perform a Fourier Transform on audio data to generate a frequency spectrum.
  • BeatDetect: a class for doing beat detection.
  • A real-time synthesis framework based around unit generators, which we call UGens.

If you are using Processing 2.0 you’ve already got Minim! So feel free to peruse this documentation and start playing with examples. If you prefer Javadocs, we got those too! Bear in mind, however, that the version of Minim included with Processing 2.0 is not the most recent version. We recommend using Processing 3.0 so that you can easily install the latest version of the library to take advantage of all the latest bug fixes and additions.

In Processing 3.0 you can install Minim from the Contribution Manager. Open the manager using the Sketch menu. Choose Import Library and then Add Library. In the Libraries tab of the Contribution Manager, type Minim in the Filter box, select the library from the list, and click Install.

If you are not using Processing, you can still use Minim! We provide a constructor for the Minim class that takes a plain Object and you simply need to define two methods that we will find using reflection.

The download includes Processing examples and source code. Minim is licensed under the GNU Lesser General Public License (LGPL), a copy of which is included with the distribution.

Download: Minim 2.2.2 zip or visit the Github 2.2.2 release page

If you have any questions about using the library you can start by checking 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!