{"id":13566321,"url":"https://github.com/mus264/264-tools","last_synced_at":"2025-04-04T00:30:30.000Z","repository":{"id":65432987,"uuid":"41943534","full_name":"mus264/264-tools","owner":"mus264","description":":musical_keyboard: Modular sound playback, processing, \u0026 performance tools for students of Max and live electronics at Harvard University","archived":false,"fork":false,"pushed_at":"2023-01-23T10:54:23.000Z","size":2983,"stargazers_count":60,"open_issues_count":2,"forks_count":11,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-11-04T20:42:26.001Z","etag":null,"topics":["audio","dsp","library","maxmsp","midi-controller","music","package","signal-analysis","signal-processing","sound"],"latest_commit_sha":null,"homepage":"","language":"Max","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mus264.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-09-05T00:42:57.000Z","updated_at":"2024-10-28T16:49:55.000Z","dependencies_parsed_at":"2023-02-12T22:31:20.771Z","dependency_job_id":null,"html_url":"https://github.com/mus264/264-tools","commit_stats":null,"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mus264%2F264-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mus264%2F264-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mus264%2F264-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mus264%2F264-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mus264","download_url":"https://codeload.github.com/mus264/264-tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247103305,"owners_count":20884023,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","dsp","library","maxmsp","midi-controller","music","package","signal-analysis","signal-processing","sound"],"created_at":"2024-08-01T13:02:07.064Z","updated_at":"2025-04-04T00:30:29.013Z","avatar_url":"https://github.com/mus264.png","language":"Max","funding_links":[],"categories":["Max"],"sub_categories":[],"readme":"# 264 Tools\n\nA modular kit providing high-level sound playback, processing and performance tools for students of Music 264 at Harvard University.\n\n![264 Tools modules](/source/modules-screenshot.png)\n\n## Installation\n\n0. If you have previously installed a copy of 264 Tools, delete it from your Max Packages directory.\n\n1. **Download the [latest release](https://github.com/mus264/264-tools/releases/latest)** (click ‘Source code’ under Assets)\n\n2. **Uncompress your download to your Max Packages directory.**    \nYou can find this under `~/Documents/Max 8/Packages` for Max 8    \nYou should end up with file paths that look like `~/Documents/Max 8/Packages/264-tools/ALL-THE-FILES-GO-HERE`.\n\n3. **Open (or restart) Max.**\n\nAlternatively if you prefer using the command line:\n\n```sh\n# move to your packages directory\ncd ~/Documents/Max 8/Packages\n# download 264 Tools to your packages directory\ngit clone https://github.com/mus264/264-tools.git\n```\n\n## Getting Started\n\nAfter you have installed 264 Tools, open Max’s **Extras** menu to find **264 Tools** \u003e **264 Tools Overview** for an introduction to the various modules.\n\nFor a quick list of all available modules check out **264 Tools** \u003e **Module Finder** in the **Extras** menu.\n\n## Checking for Updates\n\nFrom Max’s **Extras** menu, select **264 Tools** \u003e **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.)\n\n## Current Functionality\n\nThe toolkit currently includes the following modules, which should be loaded in a `bpatcher`.\n\n### Audio\n\n#### Sound Files\n\n* `264.sfplay~` — a simple sound file player\n* `264.sfrecord~` — a monophonic sound file recorder\n\n#### Processing\n\n* `264.delay~` — a single, flexible delay line\n* `264.filter~` — a highpass, lowpass or bandpass filter\n* `264.grains~` — a live audio granulation module\n* `264.ringmod~` — modulate a signal with a single frequency oscillator\n* `264.reverb~` — a basic reverb module\n* `264.transpose~` — a pitch shifter with 3 octave range above \u0026 below source\n* `264.freeze~` — a spectral audio freezer\n* `264.loop~` — a buffer-based loop recorder and manipulator\n* `264.limit~` — a no-options audio limiter (implementing `omx.peaklim~`)\n* `264.gate~` — an amplitude gate\n\n#### Analysis\n\n* `264.envelope~` — an envelope follower compatible with other modules\n* `264.pitchtrack~` — a fundamental frequency tracker\n* `264.trigger~` — an attack detector\n\n#### Utility\n\n* `264.audiotest~` — display audio status \u0026 test loudspeakers\n\n### Control\n\n* `264.key-learn` — a utility permitting quick linking of keyboard shortcuts\n* `264.midi-learn` — a utility permitting quick linking of inputs with a MIDI controller\n* `264.line` — a breakpoint function module for line playback\n* `264.tog` — a MIDI-ready toggle switch\n* `264.go!` — a MIDI-ready button\n* `264.midi-presets` — manage mapping presets for your `264.key-learn` and `264.midi-learn` objects\n* `264.audio-presets` — manage presets for parameters across 264 Tools modules\n* `264.fullscreen` — toggle a patch to display fullscreen\n* `264.lockstatus` — check if a patch is currently locked\n\n## Compatibility\n\nThe latest release of these modules requires **Max 8**. Please [report bugs under the issues tab above][issues].\n\nIf you need to support Max 6 or 7, you can [download v0.17.0][017] or lower.\n\n  [issues]: https://github.com/mus264/264-tools/issues\n  [017]: https://github.com/mus264/264-tools/releases/tag/v0.17.0\n\n## Acknowledgments\n\n`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](https://github.com/Cycling74/percolate).\n\nThe original versions of `264.midi-presets`, `264.audio-presets`, `264.loop~`, `264.sfplay~`, and `264.sfrecord~` relied on [Patrick Delges](http://www.crfmw.be/max/)’s `filesys` Java class to manage file locations. (This is now done via a custom Node.js script.)\n\nThe `264.reverb~` core is heavily based on [Randy Jones](http://madronalabs.com/)’s `yafr2` example.\n\n`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 \u0026 [Ted Apel](http://vud.org/). Included here is [Volker Böhm](http://vboehm.net/)’s [64-bit version][f9cd7a51].\n\n  [f9cd7a51]: https://github.com/v7b1/sigmund_64bit-version \"v7b1/sigmund_64bit-version - GitHub\"\n\n`264.freeze~` is adapted from [Jean-François Charles](http://www.jeanfrancoischarles.com)’s spectral freezing patches.\n\n`264.loop~` is built around [Rodrigo Constanzo](http://www.rodrigoconstanzo.com/karma) \u0026 raja’s amazing [`karma~`](https://github.com/rconstanzo/karma), which is Copyright © 2015, Rodrigo Constanzo All rights reserved. Please see the module for detailed redistribution information.\n\n`264.line` relies on an adapted version of [`simplify-js`](https://github.com/mourner/simplify-js/), which is Copyright © 2017, Vladimir Agafonkin All rights reserved and distributed under a BSD 2-Clause license.\n\n## License\n\nThis software is free to use, modify, and redistribute under a [GNU General Public License](http://www.gnu.org/licenses/gpl-3.0.txt).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmus264%2F264-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmus264%2F264-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmus264%2F264-tools/lists"}