🎹 Modular sound playback, processing, & performance tools for students of Max and live electronics at Harvard University
Max Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
code
docs
externals
extras/264 Tools
help
init
interfaces
java-classes
javascript
media
patchers
source
.gitignore
CHANGELOG.md
LICENSE.txt
README.md
icon.png
package-info.json

README.md

264 Tools

A modular kit providing high-level sound generation, processing and performance tools for students of Music 264 at Harvard University.

264 Tools modules

Installation

  1. If you have previously installed a copy of 264 Tools, delete it from your Max Packages directory.

  2. Download the latest release (click ‘Source code’ under Downloads)

  3. Uncompress your download to your Max Packages directory.
    You can find this under ~/Documents/Max/Packages for Max 6 or ~/Documents/Max 7/Packages for Max 7.
    You should end up with file paths that look like ~/Documents/Max/Packages/264-tools/ALL-THE-FILES-GO-HERE.

  4. Open (or restart) Max.

Alternatively if you prefer using the command line:

# move to your packages directory
cd ~/Documents/Max/Packages
# download 264 Tools to your packages directory
git clone https://github.com/mus264/264-tools.git

Getting Started

After you have installed 264 Tools, open Max’s Extras menu to find 264 Tools > 264 Tools Overview for an introduction to the various modules.

Checking for Updates

From Max’s Extras menu, select 264 Tools > Check for Updates. This will let you know if you need to update. (You will need to be connected to the internet for this to work.)

Current Functionality

The toolkit currently includes the following modules, which should be loaded in a bpatcher.

Audio

Sound Files

  • 264.sfplay~ — a simple sound file player
  • 264.sfrecord~ — a monophonic sound file recorder

Processing

  • 264.delay~ — a single, flexible delay line
  • 264.filter~ — a highpass, lowpass or bandpass filter
  • 264.grains~ — a live audio granulation module
  • 264.ringmod~ — modulate a signal with a single frequency oscillator
  • 264.reverb~ — a basic reverb module
  • 264.transpose~ — a pitch shifter with 3 octave range above & below source
  • 264.freeze~ — a spectral audio freezer
  • 264.loop~ — a buffer-based loop recorder and manipulator
  • 264.limit~ — a no-options audio limiter (implementing omx.peaklim~)
  • 264.gate~ — an amplitude gate

Analysis

  • 264.envelope~ — an envelope follower compatible with other modules
  • 264.pitchtrack~ — a fundamental frequency tracker
  • 264.trigger~ — an attack detector

Utility

  • 264.audiotest~ — display audio status & test loudspeakers

Control

  • 264.midi-learn — a utility permitting quick linking of inputs with a MIDI controller
  • 264.tog — a MIDI-ready toggle switch
  • 264.go! — a MIDI-ready button
  • 264.midi-presets — manage mapping presets between your MIDI controller and 264.midi-learn objects
  • 264.audio-presets — manage presets for parameters across 264 Tools modules
  • 264.fullscreen — toggle a patch to display fullscreen
  • 264.lockstatus — check if a patch is currently locked

Compatibility

These modules have been tested with Max 6 and 7. They will not work with Max/MSP 5 or lower. Please report bugs under the issues tab above.

Acknowledgments

264.grains~ relies on the munger~ granulation external, which has a substantial ancestry including work by Ivica Ico Bukvic, Ji-Sun Kim, Dan Trueman, and R. Luke DuBois, most recently for percolate.

264.midi-presets, 264.audio-presets, 264.sfplay~, and 264.sfrecord~ rely on Patrick Delges’s filesys Java class to manage file locations.

The 264.reverb~ core is heavily based on Randy Jones’s yafr2 example.

264.pitchtrack~ is built around the sigmund~ sinusoidal analysis and pitch tracking external, originally developed by Miller Puckette, ported to Max/MSP by Miller Puckette, Cort Lippe & Ted Apel. Included here is Volker Böhm’s 64-bit version.

264.freeze~ relies on Jean-François Charles’s spectral freezing patches.

264.loop~ is built around Rodrigo Constanzo & raja’s amazing karma~, which is Copyright © 2015, Rodrigo Constanzo All rights reserved. Please see the module for detailed redistribution information.

License

This software is free to use, modify, and redistribute under a GNU General Public License.