Optional mods for the Polyend Tracker+, built into Polyend's Tracker Community Edition (CE) firmware. It continues Modular-Trackular, which patches stock firmware 1.2.0.
MT+ is unofficial and not affiliated with Polyend, who don't support these builds. Please don't report problems with them to Polyend.
Everything CE does is here too. There is one firmware file, and each mod has its own Off/On switch, so there's no separate build for each mix of mods.
| Mod | What it does | Settings |
|---|---|---|
| Humanize | A Humanize button on page 3 of the Pattern screen's bottom bar gives the selected notes small random changes in the Micro-move (m) and Volume (V) columns. It works in edit mode, and Undo reverts it. |
Project Settings → Humanize |
| Global Swing | Every take and pattern start uses the project's Swing amount (25–75). A Swing FX still works for the rest of its pattern. | Project Settings → Global Swing |
| Master FX | Three slots on the Master screen, Reverb, Delay and Limiter, each playing CE's own effect (Stock) or a plugin (.ptmfx) from /MasterFX/ on the card. The firmware writes its default pack there: reverb Freeverb, Plate, Spring, Shimmer, "Gated" or Reverse, delay Tape or BBD, and the compressors Glue and Compressor for the Limiter slot (what each does); anyone can build more (docs/masterfx_plugins.md). Choose them on the Master screen, also while playing. A slot's page shows the plugin's names for CE's knobs and up to two knobs of its own. Glue has its own Attack, Release and Threshold, and a Tracks list: it compresses the whole mix, or only the tracks you mark, together. A plugin that can duck, such as Compressor, has a Ducks list on the Limiter page: it then turns the tracks you mark down by the key instead of the whole master. Every send goes through the slots as it does through CE's, synths included. Some plugins cost more CPU than CE's own. |
Master screen, or Project Settings → Master FX |
| Color Song | Song screen blocks get a colour from their content, so the same material is easy to follow through a song. Colours stay put and are saved with the project. | On/Off only |
| Variable Track Length | Each track of a pattern can have its own length. A short track loops until the pattern ends, then every track starts again together. Hold Trk Len on page 3 of the Pattern screen's bottom bar and turn the encoder. Past its length a track shows its loop in grey, and CE's conditions on the Chance FX count its own loops. Lengths are saved with the project. | On/Off only |
| Copy to New | A Copy to New button on page 3 of the Pattern screen's bottom bar copies the pattern you're on into the next empty pattern, with your unsaved edits and every track's length, playing or stopped. You stay on your pattern. A pattern counts as empty only if it isn't in the song and has nothing in any step, even past its length. With Variable Track Length on, the copy gets the Trk Len lengths too. It works in edit mode. | On/Off only |
| Song Loop | Repeat a block of song positions. In the Song screen's pattern column, with Rec on, Shift + Down selects the block and Play Selection repeats it; Continue Song plays the block out and goes on. During the loop Up/Down and the jog wheel move the block. The status bar shows the loop. Designed by P-N-E-M for 1.2.0. | On/Off only |
| Synths | Three more synth models in the picker: WAVE (wavetable, two oscillators, a filter, three envelopes, two LFOs and a mod matrix), PHASE (phase distortion, after the Casio CZ) and DCO6 (virtual analog after the Juno-106: one oscillator, a resonant low-pass and a high-pass, one envelope, one LFO, with Unison and Vintage). They are .psyn plugins, WAVE.psyn, PHASE.psyn and DCO6.psyn, in the card's Synths folder beside CE's engines (install step 3). Their effects are Synth FX's slots (below). Patches save as CE's do. Off hides the models; a part already playing one keeps it. 1.2.0 projects' WAVE and PHASE parts aren't converted. |
Project Settings → Synths |
| Synth FX | Two effect slots, FX1 then FX2, on each synth part, every engine (CE's eight, WAVE, PHASE and DCO6). Each slot picks a plugin (.ptsfx) from /SynthFX/ on the card; the firmware writes its default pack there (Overdrive, Distortion, Bit Crusher, Chorus, Flanger, Phaser; what each does), and anyone can build more (docs/synthfx_plugins.md). In the patch editor, button 3 shows the part's slots and the plugin's knobs. The slots belong to the part, not the patch, so loading another patch keeps them, and they are saved with the project; an old WAVE or PHASE patch has its own effects moved into the slots. On PERC the effects reach the main output, not its sends. The Distortion and Phaser cost the most CPU: 8 DIRT voices with both on every part reach about 95 %. A slot always runs on the part, after the engine; WAVE's old Placement Pre is gone, and a project saved with it opens with those slots on the part. |
Patch editor → button 3 |
Every mod is tested on hardware.
The chord inversions (which value plays which chord) and conditional trigs
from the 1.2.0 mods are now part of CE itself, though CE's conditions differ, so a 1.2.0 project's
conditional trigs read as CE's. Still to port, with no
dates: Legato, FX Interpolation,
the pad visualizer, slice Loop and live resampling. The plan is in docs/mt/CE_PORT_PLAN.md.
- Config → Mods sets which mods are on in new projects.
- Project Settings → Mods sets which are on in the open project. The choice is saved with the project, so each project can have its own set.
- With a mod Off, its code doesn't run and that part of the firmware is CE's. One thing differs in every MT+ build, whichever mods are on: the mods get 1 MiB of sample memory, so the longest stereo recording is 5:50 instead of 5:56.
- A project that used these mods on 1.2.0 brings its Humanize, Global Swing, Master FX, Color Song and track length settings with it the first time it opens.
MT+ is for the Tracker+ only. The Original Tracker and Tracker Mini builds from this branch have no mods.
- Back up your SD card's
Projectsfolder. CE saves patterns in a newer format that 1.2.0 can't read.tools/ce_to_120.pymakes a copy of a project that 1.2.0 can open, without the things only CE has. - Get the firmware. Download
TrackerPlus_MT_<release>.ptffrom the latest release. Each release is tagged for what it adds: a mod and its version (resample-1.0), or a merge of CE's updates (CE_YYYYMMDD). You can also build it withmake plus(see Building Firmware below), which makesbuild/TrackerPlus_MT_1.0.0.ptf. - Copy the synth engines to the card. Every synth engine is a
.psynfile on the card, not part of the firmware: CE's (ACD, FAT, VAP, WTFM, PERC, DIRT and CHIP) and the Synths mod's WAVE, PHASE and DCO6. Each release has all ten inPolyendTracker_CE_Synths.zip, andmake psynputs them inbuild/Synths/. Copy theSynthsfolder to the card's root. Without the folder, a project's synth parts can open on another engine, since the project stores each part's engine by its place in the list. Also copy theWordsfolder fromPolyendTracker_CE_Words.zipto the card's root: CE picks new project names from its two lists, and without them it uses 16 words of each kind. - Flash it as in
Flashing on Hardware & Emergency Recovery
below. Config then shows the version as
1.0.0 MT.
modular, this branch, holds the mods.mainis an untouched copy of polyend/tracker-ce.- The mods are in
core/mods/, and changes to CE's own files are marked// MT:. - Tests are in
core/mods/tests/(on the computer) andtools/emu/(in an emulator). CLAUDE.mdhas the rules for adding code: what runs in the audio interrupt, the display limit and memory.docs/mt/CE_FIRMWARE_MAP.mdmaps CE on the Tracker+.
CE's LICENSE and NOTICE.md apply here, as in
License below. They don't allow selling .ptf builds. The closed synth
libraries in synth/lib/ have a license of their own.
The rest of this page is CE's own README, unchanged. On this branch its build output is
named TrackerPlus_MT_*.ptf rather than TrackerPlus_CE_*.ptf.
Welcome to the Polyend Tracker Community Edition repository!
Built directly from the original Polyend firmware source code, Tracker CE opens up the Polyend Tracker platform to musicians, sound designers, and developers around the world. Whether you are here to flash the latest Community Edition firmware, want to build your own idea on the Tracker, design custom themes and fonts, write Sample Editor plugins, or build new synthesizer engines, we are excited to have you here.
- See Releases for the latest official downloads for all devices.
- See
CHANGELOG.mdfor the full list of changes in the official tagged releases.
Automatically built from the latest changes in main (for all 3 devices):
- Download the latest Beta Firmware builds (
.zip) - Download the latest SD Card Content (
.zip) (/Words,/Effects,/Synths) - See
UPCOMING.mdto find out what's new in these Beta Builds.
A Quick Note Before Flashing or Modifying Firmware
Thanks to the Tracker's isolated bootloader and hardware emergency recovery button (see Flashing on Hardware & Emergency Recovery), experimenting with Community Edition builds is very safe. Even if a custom build fails to boot, you can easily re-flash a stable
.ptfimage from your microSD card. That said, we still need to include the standard legal disclaimer just in case:
- Provided "AS IS" Without Support Obligation: While the foundation of this repository was originally developed and released by Polyend, the Polyend Tracker Community Edition (CE) firmware, source code, and any community-developed modifications or plugins are provided "AS IS", without warranty of any kind, express or implied. Polyend has no obligation to provide official technical support, maintenance, bug fixes, or customer service for Community Edition firmware or custom builds.
- Use at Your Own Risk: Flashing, modifying, or running custom firmware is done at your own discretion and risk. Polyend is not liable for any data loss, project corruption, malfunction, or hardware damage (including "bricking" a device or issues caused by code modifications) arising from the use of this software.
- Out-of-Warranty Repairs Available: In the unlikely event that something ever goes wrong with your hardware while using custom firmware, it is not covered under standard warranty. However, Polyend is always happy to help get your instrument back up and running through its official out-of-warranty repair service (standard service, parts, and shipping fees apply. See How to Contact Polyend Customer Support).
This unified codebase powers all three hardware instruments in the Tracker family:
- Original Polyend Tracker (
NXP Kinetis MK66FX1M0, Cortex-M4F @ 180 MHz) - Polyend Tracker+ & Tracker Mini (
NXP i.MX RT1051/RT1064, Cortex-M7 @ 600 MHz)
.
├── Makefile # Unified top-level build & version management
├── version.mk # Centralized version & build number configuration
├── CHANGELOG.md # Stable release history & feature highlights
├── UPCOMING.md # Unreleased changes currently in the beta builds
├── CONTRIBUTING.md # Contribution rules & hardware testing workflow
├── LICENSE # MIT License (+ No Wholesale Commercial Clones & Precompiled Synth Terms)
├── NOTICE.md # Third-party open-source attributions
├── core/ # Shared Tracker application, audio engine, UI (GlobalFileBrowser, editors) & synth host glue
├── platforms/
│ ├── mk66/ # Original Tracker (Kinetis MK66) HAL, drivers & linker scripts
│ └── imx/ # Tracker+ & Tracker Mini (i.MX RT1051) HAL, drivers & linker scripts
├── synth/
│ ├── include/PolySynth/ # PolySynth public headers & Open Synth SDK (synth/include/PolySynth/sdk/)
│ ├── source/ # Open-source PolySynth host, PsynLoader, PolyDSP (Amplifier/Mixer) & Master FX
│ └── prebuilt/ # Precompiled factory .psyn synth plugins + LICENSE-PROPRIETARY.txt
├── synth-plugin-sdk/ # .psyn loadable Synth Engine SDK, builder & engines/ sources
├── util/ # Shared C++ utility headers & third-party header libraries (ETL, magic_enum)
├── editor-fx-sdk/ # .ptfx Sample Editor plugin SDK, builder & effects/ sources
└── docs/ # User guides, SDK tutorials & architecture documentation
This repository prioritizes workflow continuity: our aim is to respect existing muscle memory, introduce features, optimizations and improvements that fit the original vision of the device, while fixing bugs along the way.
If you have ideas for major workflow adjustments or structural changes, please open a GitHub Discussion or a topic on the Polyend Backstage Forum first, so we can align on direction together with the community.
For radical experiments or reimagined interfaces, we actively encourage community forks!
We welcome community contributions! ❤️
From bug fixes and workflow improvements to new open-source synth engines and .ptfx Sample Editor plugins. Please read CONTRIBUTING.md for our project philosophy, pull request rules, hardware testing workflow, and technical checklist before opening a Pull Request.
- GNU Arm Embedded Toolchain
10.3-2021.10:- Direct official downloads from Arm:
- Linux (
x86_64):gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2 - Linux (
aarch64/ ARM64):gcc-arm-none-eabi-10.3-2021.10-aarch64-linux.tar.bz2 - macOS (
x86_64/ Apple Silicon via Rosetta):gcc-arm-none-eabi-10.3-2021.10-mac.tar.bz2 - Windows (ZIP):
gcc-arm-none-eabi-10.3-2021.10-win32.zip
- Linux (
- Ensure
arm-none-eabi-gccis on yourPATH, extract the toolchain into./agt/10.3/, or passTOOLCHAIN=/path/to/arm-none-eabi-tomake.
- Direct official downloads from Arm:
make(for building firmware) andpython3(used bymake ptfxto package.ptfxSample Editor plugins and by themake bump-*version helpers; standard library only).
From the repository root:
# Build all three devices (Original Tracker, Tracker+, Tracker Mini)
make all
# Or build a single target:
make original # -> build/PolyendTracker_CE_1.0.0.ptf
make plus # -> build/TrackerPlus_CE_1.0.0.ptf
make mini # -> build/TrackerMini_CE_1.0.0.ptf
# Build reference .ptfx Sample Editor effects into editor-fx-sdk/build/Effects/:
make ptfx
# Build open-source .psyn synths (CHIP.psyn; MT+: WAVE.psyn, PHASE.psyn and DCO6.psyn) and stage all factory + open-source .psyn plugins into build/Synths/:
make psyn
# Or compile only the synth-plugin-sdk reference plugin (CHIP.psyn -> synth-plugin-sdk/build/):
make -C synth-plugin-sdk
# Clean all build directories:
make cleanAll firmware version numbers are defined in version.mk. The Build identifier displayed on the hardware under Config > Firmware > Build is automatically populated from the short Git commit hash (git rev-parse --short=7 HEAD):
# Show current version, Git build hash & output filenames
make version
# Increment patch version (e.g. 1.0.0 -> 1.0.1)
make bump-patch TARGET=all # or TARGET=original | TARGET=plus | TARGET=mini
# Increment minor version (e.g. 1.0.x -> 1.1.0)
make bump-minor TARGET=all # or TARGET=original | TARGET=plus | TARGET=mini- Copy the generated
.ptffile frombuild/(PolyendTracker_*.ptf,TrackerPlus_*.ptf, orTrackerMini_*.ptf) to the/Firmware/folder on your Tracker's microSD card.- Note: Keep
.ptffilenames at 31 characters or fewer so the Original Tracker's 32-byte/Firmware/_fwinfobootloader buffer remains null-terminated.
- Note: Keep
- On the device, open Config > Firmware > Firmware update, select the
.ptffile, and confirm.
If you prefer a video, have a look here: https://youtu.be/1F6wx2ftFVA
Bootloader Resilience & Emergency Firmware Recovery:
- The Polyend Tracker bootloader is isolated from the application firmware:
- On the Original Tracker (
MK66), the bootloader runs on a separate dedicated microcontroller (kBootloaderTrig).- On Tracker+ and Tracker Mini (
IMX), the bootloader resides in a protected region at the bottom of QSPI Flash (0x60000000–0x6002FFFF), while.ptfapplication builds are linked starting at0x60030000(do not modify the flashORIGINaddress in the linker scripts).- Emergency Recovery: If a custom firmware build ever hangs or fails to boot into the UI, you can always recover your device:
- Place a known-good, stable
.ptffirmware file for your device inside the/Firmware/folder on your microSD card (ideally as the only.ptffile in/Firmware/).- Insert the microSD card into your Tracker and power it on.
- Use a paperclip or SIM-eject pin to press the recessed hardware Reset / Emergency Bootloader pinhole button (located on the bottom of the Original Tracker / Tracker+, or next to the USB-C port on Tracker Mini). The hardware bootloader will automatically pick up the
.ptffile from/Firmware/and flash it.
Full user and developer documentation is available in docs/ and on the repository Wiki:
- User Guides:
- Developer & Architecture Guides:
This repository is part of a growing open-source ecosystem around the Polyend Tracker family:
polyend/tracker-theme-editor(Live Web App): Browser-based visual Theme & Font Editor with a hardware screen simulator.polyend/tracker-lib: Open-source library and tools for reading, writing, and inspecting Polyend Tracker project (.mt), pattern (.mtp), and instrument (.pti) files.- Polyend Backstage Forum: Community forum for sharing custom themes, fonts,
.ptfxplugins, synth engines, and discussing workflows. - The Tracker Overflow (Discord): Unofficial Polyend Tracker Discord where users and developers can join, chat, and find like-minded people.
- Source Code, SDKs, Open Synth Engines (
synth-plugin-sdk/),.ptfxSample Editor SDK (editor-fx-sdk/), PolySynth Host & DSP (synth/source/), Drivers & Utilities: Licensed under the MIT License with a Wholesale Commercial Clone Restriction (seeLICENSE).- Musicians & Creators: Using the firmware for commercial music production, albums, paid live performances/gigs, sample packs, and monetized streaming/YouTube content is expressly permitted.
- Developers & Plugin Authors: Reusing individual source files, drivers, DSP algorithms, UI widgets, or open-source C++ synth engines (
CHIP, etc.) in your own open-source or commercial projects—and selling custom.ptfxSample Editor or custom.psynsynth plugins—is expressly permitted under the MIT License. - No Wholesale Commercial Clones: You may not sell compiled
.ptffirmware builds, manufacture/sell commercial clone hardware running the Tracker firmware, or sell a direct port/wholesale clone of the complete Tracker application as a paid software product.
- Precompiled Factory Synth Plugins (
synth/prebuilt/*.psyn): Provided under the Polyend Precompiled Factory Synthesizer Plugins License, permitting free use on authentic Polyend hardware as well as personal/DIY non-commercial projects (commercial embedding or paid distribution of these proprietary factory.psynbinaries is prohibited). - Third-Party Components: See
NOTICE.md.