A Max/MSP package of gen~ based tools to generate XY (and XYZ) coordinates — exploring different methods to interact with movements, trajectories and location in a two dimensional space.
Every generator is a gen~ patcher that outputs signal-rate coordinates normalised between 0. and 1., ready to drive panning, granular playback, wavetable scanning, Jitter matrices, MIDI or OSC.
- Version: 1.2.0
- Author: Daniele Fabris — danielefabris.com
- Requires: Max 8.0 or later (macOS Intel/Apple Silicon, Windows x64)
Option A — manual
- Download or clone this repository.
- Rename the folder to
XY Coordinates Generator Pack. - Move it into your Max packages folder:
- macOS:
~/Documents/Max 9/Packages/ - Windows:
Documents\Max 9\Packages\
- macOS:
- Restart Max.
Option B — clone directly
cd ~/Documents/Max\ 9/Packages
git clone https://github.com/dnlfbr/xy-coordinates-generator-pack.git "XY Coordinates Generator Pack"Once installed, open Extras → XY_overview in Max to browse the whole package.
| Object | What it does |
|---|---|
xy.MANUAL~ / xy.MANUAL4~ |
Hand-drawn positions, 1 or 4 independent points |
xy.RANDOM~ |
Randomised drift across the plane |
xy.WAVE~ |
Lissajous-style motion from paired oscillators |
xy.FM~ / xy.FM3~ |
FM modulation of the coordinate pair, 2 or 3 operators |
xy.GALAXY~ |
Orbital / spiral trajectories |
xy.MASS~ |
Physics-driven motion with mass and inertia |
xy.GRAINS~ |
Scattered cloud of points, granular-oriented |
xy.MULTI~ |
Multiple simultaneous coordinate streams |
xy.SEQUENCE4~ / xy.SEQUENCE8~ |
Step-sequenced positions, 4 or 8 steps |
xyz.lorenz~ · xyz.chen~ · xyz.thomas~ · xyz.halvorsen~ · xyz.sprott~ · xyz.dadras~ · xyz.fourwing~
Each outputs three normalised signal coordinates tracing the attractor's phase space.
Found under examples/, openable from Max's file browser:
| Example | Focus |
|---|---|
XY Spatialisation |
Multichannel panning driven by coordinates |
XY Granular Sampler |
Coordinates as grain position / spread |
XY Vector Wavetable |
2D wavetable scanning |
XY Jitter / XY Jitter 2 |
Writing coordinates into Jitter matrices |
XY Collision |
Boundary and collision behaviours |
XY MIDI |
Coordinates to MIDI control |
XY OSC |
Coordinates over OSC |
The folder structure follows the Max package specification — the directory names are fixed and must not be renamed or reorganised, or Max will stop finding the contents.
.
├── package-info.json Package manifest read by Max
├── patchers/ The gen~ generator abstractions (the objects you use)
├── code/ .gendsp sources for each generator
├── help/ Help patchers (right-click an object → Open Help)
├── examples/ Complete example patches
├── extras/ XY_overview.maxpat — the package home patcher
├── clippings/ Drag-and-drop clippings
├── snippets/ Max snippets
├── collections/ Snippet collection
├── media/ SVG assets used by the UI
└── icon.png Package icon
- All outlets carry a signal ranging from 0. to 1.
- The
gen~code is optimised to work in multichannel (mc.) contexts.
For support, collaboration and inspiration:
Music Informatics — Umanesimo Artificiale, Tauro Venturini, Filippo Rosati, Francesco Corvi, Emanuele Balia, Artiom Costantinov, Sasha Petra
GRAIM — Nicola Di Paolo, Franco Conte, Davide Tiso, Lorenzo Pagliei, Carmine Emanuele Cella
STEIM — Fedde ten Berge
Released under the MIT License — see LICENSE.
Daniele Fabris — LEDEN / @musicinformatics