A terminal-based music tracker powered by SuperCollider.

IMPORTANT NOTE: this software is currently in development and is definetly unstable and chock full of bugs.

COMPATIBILITY WARNING: Major version changes (X.0.0 -> Y.0.0) are not backward compatible. Save files from version X.0 cannot be used with version Y.0 and vice versa. Back up your projects before upgrading across major versions.

This is a music tracker designed to be used with any terminal (Linux, macOS, Windows WSL/terminal). It is the first tracker (to my knowledge) that uses SuperCollider as the sound engine, which allows for very flexible sound design and synthesis.

• SuperCollider (required; extensions are checked at launch). Download here.
• SuperCollider extensions (required): Download here
• collidertracker binary. See installation options below.

ColliderTracker will automatically download required SuperCollider extensions on first run if they are not already installed. These extensions are downloaded to your system's standard SuperCollider extensions directory:

• macOS: ~/Library/Application Support/SuperCollider/Extensions
• Linux: ~/.local/share/SuperCollider/Extensions
• Windows: %LOCALAPPDATA%/SuperCollider/Extensions

The following extensions are automatically downloaded:

• PortedPlugins (schollz/portedplugins) - Audio effects including Fverb and AnalogTape
• mi-UGens (v7b1/mi-UGens) - Mutable Instruments synthesizer modules including MiBraids

First, open the SuperCollider IDE by searching for and running 'SuperCollider IDE'. The IDE should open and give you three main panes:

• a large blank text window
• a help window
• a post window containing text about how the startup process went.

Secondly, boot the server using the command in the Language menu, or Ctrl+B.

Thirdly, enter the following into the blank text window:

{SinOsc.ar}.play

Ensure the cursor is on this line and hit Ctrl+Enter. You should now hear a sine tone. Kill the sine tone by hitting Ctrl+.. If you don't hear the tone, remember to check your speakers, volume control – all the regular suspects!

Option 1: Homebrew (Recommended)

brew tap schollz/tap
brew install collidertracker

Option 2: Manual Download Grab the latest build from Releases.

Grab the latest build from Releases.

Option 1: (Recommended)

Simply run collidertracker - it will automatically detect if SuperCollider is already running with ColliderTracker code, or start a new instance if needed:

./collidertracker

Note: On Windows, you may need to add SuperCollider to the list of approved programs. Run the following commands in an Administrator-level PowerShell:

Add-MpPreference -ExclusionProcess "C:\Program Files\SuperCollider-3.13.0\sclang.exe"
Add-MpPreference -ExclusionProcess "C:\Program Files\SuperCollider-3.13.0\scsynth.exe"

Option 2: Manual SuperCollider Management

If you prefer complete manual control:

1. Run SuperCollider and then open collidertracker/internal/supercollider/collidertracker.scd in SuperCollider. Then, in SuperCollider, goto "Language" -> "Evaluate File". SuperCollider should become Active.
2. Run collidertracker with the --skip-sc flag to bypass all detection and management:

./collidertracker -s

ColliderTracker offers two types of recording:

• Records the entire session from start to finish
• Output saved to SuperCollider's default recordings folder
• Captures everything: all tracks, effects, and audio output
• Automatic recording begins when the program starts

• Context-aware recording of active tracks only
• Records current track (Chain/Phrase view) or all active tracks (Song view)
• Output: Generates master mix + individual track stems with timestamps
• Toggle recording on/off during playback for selective capture

The Modulation system provides powerful note transformation capabilities for both Instrument and Sampler tracks. Access it by navigating to a MO (Modulate) column value and pressing Shift+Right.

Modulation settings allow you to:

• Add controlled randomness to notes
• Apply mathematical transformations (add/subtract)
• Quantize notes to musical scales
• Create incremental note sequences
• Control probability of modulation effects

Modulation is applied in this sequence:

1. Increment - Added based on playback counter (if active)
2. Random Variation - Applied if IRandom > 0 and Seed is not "none"
3. Subtraction - Sub value is subtracted
4. Addition - Add value is added
5. Scale Quantization - Note is quantized to nearest scale note (if not "all")

• Seed: random, IRandom: 12, Sub: 6, Add: 0
• Adds ±6 semitones of random variation to notes

• Increment: 2, Wrap: 12
• Each successive trigger moves the note up 2 semitones, wrapping after 12 semitones

• ScaleRoot: C, Scale: major, Probability: 75%
• 75% chance to quantize notes to C major scale

• Seed: 42, IRandom: 24, Sub: 12, Add: 5, Scale: minor
• Reproducible random variations within a minor scale

Instrument Tracks: Modulation applies to:

• Individual notes when no chord/arpeggio is active
• All chord notes when chords are used without arpeggio
• All arpeggio notes (including root) when arpeggio is active

Sampler Tracks: Modulation applies to the sample's playback pitch

• Use fixed seeds (1-128) for reproducible "random" patterns
• Set Probability < 100% to create organic, non-mechanical variations
• Combine Increment with Wrap for cyclical melodic patterns
• Use scale quantization to keep random variations musically coherent

The C key provides context-aware trigger and fill functionality across all views:

• Non-empty row: Triggers EmitRowDataFor with complete parameter set:
  • Instrument tracks: Note, Chord (C/A/T), ADSR (A/D/S/R), Arpeggio (AR), MIDI (MI), SoundMaker (SO)
  • Sampler tracks: All traditional sampler parameters
• Empty row: Copies last row with increment

• Non-empty slot: Triggers first row of the referenced phrase
• Empty slot: Fills with next unused phrase

• Non-empty slot: Finds first phrase in referenced chain and triggers its first row
• Empty slot: Fills with next unused chain

This unified approach allows instant playback testing of any musical element while maintaining the original fill functionality for composition workflow.

SL  DT  NN  PI  GT  RT  TS  Я  PA  LP  HP  CO  VE  VL  MO  FI

SL  DT  NOT  C  A  T  A D S R  AR  MI  SO  VL  MO

• SL (slice) – Row number display
• DT (delta time) – Unified playback control: --/00 = skip, >00 = play for N ticks
• NN/NOT (note) – MIDI note (hex) or note name
• PI (pitch) – Pitch bend (sampler only)
• GT (gate) – Note length/gate time
• RT (retrigger) – Retrigger effect index
• TS (timestretch) – Time-stretch effect index
• Я (reverse) – Reverse playback probability (0-F hex: 0=0%, F=100%)
• PA (pan) – Stereo panning
• LP/HP (filters) – Low-pass/High-pass filters
• CO (comb) – Comb filter effect
• VE (reverb) – Reverb effect
• VL (velocity) – Note velocity (0-F hex, affects volume and expression)
• MO (modulate) – Modulation settings index for note randomization and scaling
• FI (file index) – Sample file selection (sampler only)
• C (chord) – Chord type: None(-), Major(M), minor(m), Dominant(d) (instrument only)
• A (chord addition) – Chord addition: None(-), 7th(7), 9th(9), 4th(4) (instrument only)
• T (transposition) – Chord transposition: 0-F semitones (instrument only)
• A D S R (ADSR) – Attack/Decay/Sustain/Release envelope (instrument only)
• AR (arpeggio) – Arpeggio pattern index (instrument only)
• MI (MIDI) – MIDI settings index for external MIDI output (instrument only)
• SO (SoundMaker) – SoundMaker settings index for built-in synthesis (instrument only)
• VL (velocity) – Note velocity (0-F hex, affects volume and expression)

Both Sampler and Instrument views now use the same DT (Delta Time) column for playback control, replacing the previous separate P/DT system. This provides consistent behavior across both track types.

The VL (Velocity) column provides expressive control over note dynamics. SuperCollider tracks and responds to velocity values for both volume and expression, enabling more musical and dynamic performances.

The Я (Reverse) column in Sampler view now uses a probability system instead of a simple on/off flag:

• 0 = Never reverse (0% chance)
• 1 = ~6.7% chance to reverse
• F = Always reverse (100% chance)
• Values 1-E = Linear probability scaling between 6.7%-93.3%

Each time a note plays, the system randomly determines whether to apply reverse playback based on the probability value, adding dynamic variation to your tracks.

The application now uses a local folder structure (tracker-save/) instead of a single save file, automatically storing samples and their metadata together for complete project portability.

• Go (latest stable version)
• C/C++ compiler (GCC on Linux, Xcode on macOS, MinGW on Windows)
• System dependencies (varies by platform)

1. Install MSYS2: Download from https://www.msys2.org/

2. Install required packages in MSYS2 terminal:

   pacman -S --noconfirm mingw-w64-x86_64-rtmidi mingw-w64-x86_64-toolchain

3. Set environment variables:

   export CGO_ENABLED=1
   export CC=x86_64-w64-mingw32-gcc
   export CGO_LDFLAGS=-static
   export CGO_CXXFLAGS="-D__RTMIDI_DEBUG__=0 -D__RTMIDI_QUIET__"

4. Build:

   go build -v -o collidertracker.exe

1. Install dependencies with Homebrew:

   brew update
   brew install pkg-config rtmidi sox

2. Set environment variables:

   export CGO_ENABLED=1
   export CGO_CXXFLAGS="-D__RTMIDI_DEBUG__=0 -D__RTMIDI_QUIET__"

3. Build:

   go build -v -o collidertracker

1. Install dependencies (Ubuntu/Debian):

   sudo apt-get update
   sudo apt-get install -y libasound2-dev sox

   For other distros: Install equivalent packages for ALSA development headers and SoX

2. Set environment variables:

   export CGO_CXXFLAGS="-D__RTMIDI_DEBUG__=0 -D__RTMIDI_QUIET__"

3. Build:

   go build -v -o collidertracker

For a fully static binary that runs on any Linux system:

1. Use Alpine Linux environment (Docker recommended):

   docker run --rm -v $(pwd):/workspace -w /workspace golang:1.25-alpine sh -c '
   apk add --no-cache git build-base autoconf automake libtool linux-headers alsa-lib-dev sox &&
   cd /tmp &&
   git clone https://github.com/alsa-project/alsa-lib.git &&
   cd alsa-lib && git checkout v1.2.10 &&
   libtoolize --force --copy --automake && aclocal && autoheader &&
   automake --foreign --copy --add-missing && autoconf &&
   ./configure --prefix=/usr/local --enable-shared=no --enable-static=yes --disable-ucm &&
   make -j$(nproc) && make install &&
   cd /workspace &&
   export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH" &&
   export CGO_CFLAGS="-I/usr/local/include" &&
   export CGO_LDFLAGS="-L/usr/local/lib" &&
   export CGO_CXXFLAGS="-D__RTMIDI_DEBUG__=0 -D__RTMIDI_QUIET__" &&
   CGO_ENABLED=1 go build -buildvcs=false -ldflags "-linkmode external -extldflags \"-static -L/usr/local/lib\"" -o collidertracker
   '

After building, verify the binary works:

./collidertracker --help

• The build requires CGO (C bindings) for MIDI and audio functionality
• Static linking is used on Windows and in the Alpine Linux build for portability
• The RTMIDI debug flags are disabled for release builds to reduce verbosity
• Version information can be embedded using: go build -ldflags "-X main.Version=<version>"

• Renoise
• SunVox
• DefleMask
• dirtywave m8

• OpenMPT (ModPlug Tracker)
• MilkyTracker
• Schism Tracker
• Furnace
• Radium Music Editor
• Psycle
• Buzztrax
• SoundTracker (GTK/Unix) · Source
• ChibiTracker
• Propulse Tracker
• Pata Tracker

• FastTracker II (original info) · ft2-clone
• ProTracker 2 clone (pt2-clone)
• HivelyTracker
• Impulse Tracker (mirror)
• Scream Tracker 3
• Skale Tracker
• MadTracker

• LSDj (Little Sound Dj)
• 0CC-FamiTracker
• FamiStudio · Website
• LittleGPTracker (LGPT) · Website
• NitroTracker · GitHub Fork
• klystrack · Itch.io page
• Lovely Composer

• GoatTracker 2
• SID Factory II
• CheeseCutter
• SID-Wizard (C64 release info)
• JITT64 (Java Ice Team Tracker)

• BambooTracker
• Protrekkr
• Reality Adlib Tracker (RAD)

• BassoonTracker · Live Demo
• XO-Tracker DEMO
• Sound Composer NX

• Shield Tracker (sTracker) · Shortcuts
• 1tracker (1-bit ZX/retro)
• WaveTracker
• Oxide Tracker

To completely remove all ColliderTracker-related data from your system:

• Delete the ColliderTracker binary from wherever you installed it (e.g., /usr/local/bin/collidertracker or the downloaded location)
• Delete your project directory (default: ./save/ in the directory where you run ColliderTracker, or custom directory specified with -p flag)

ColliderTracker automatically downloads SuperCollider extensions to the following locations:

• macOS: Remove ~/Library/Application Support/SuperCollider/Extensions/PortedPlugins/ and ~/Library/Application Support/SuperCollider/Extensions/mi-UGens/
• Linux: Remove ~/.local/share/SuperCollider/Extensions/PortedPlugins/ and ~/.local/share/SuperCollider/Extensions/mi-UGens/
• Windows: Remove %LOCALAPPDATA%/SuperCollider/Extensions/PortedPlugins/ and %LOCALAPPDATA%/SuperCollider/Extensions/mi-UGens/

Note: These extensions may also be used by other SuperCollider applications. Only remove them if you're sure they're not needed by other software.

ColliderTracker may create temporary .scd files in your system's temp directory during operation. These are automatically cleaned up when the application exits, but you can manually remove any remaining files with names like:

• collidertracker_*.scd
• dx7_*.afx
• dx7_*.scd

If you used the recording feature (-r flag), recordings are saved to SuperCollider's default recordings directory. You may want to back up or remove these files:

• macOS: ~/Music/SuperCollider Recordings/
• Linux: ~/SuperCollider/
• Windows: %USERPROFILE%/Music/SuperCollider Recordings/

LOC:

cloc --by-file --include-ext=go --not-match-f='dx7' internal

MIT