Skip to content

tracker-ff 1.2.0

Choose a tag to compare

@sbialy sbialy released this 09 Nov 13:05
· 8 commits to main since this release

Plugins, synth automation and more sample effects for the original Polyend Tracker. tracker-ff is unofficial community firmware, built on Polyend's open source tracker-ce, that gives the original Tracker synth engines of its own, made for its hardware and its memory. Version 1.2.0 moves most engines and a new set of master effects onto the SD card as plugins, adds an automation page to the synth, brings seven new sample editor effects, runs the synth maths faster and picks up three community features from tracker-ce forks.

Re-issued on 2026-11-09. The first 1.2.0 build could hang at the end of power off, with the screen on and every key dead. This build switches off every time. If you flashed 1.2.0 before this note, flash PolyendTracker_FF_1.2.0.ptf again. The first build has a checksum that starts with 02be31c5, this one starts with a165597f.

What is new in 1.2.0

  • Master insert plugins. Two insert slots process the master bus after the track mixers and before the limiter. Seven inserts ship with the release: Dirt, Tape, Lo-Fi, Console, Tube, BBD and Phaser. Copy the .plg files to /Plugins/Master/ on the SD card. Press the Master button to cycle Master, Track Mixer, Global Mixer and then the new Inserts page, which appears as soon as a plugin is on the card. Shift + Saturation on the Master screen opens it directly. Columns 2 and 3 pick the plugin for insert 1 and insert 2 (Delete empties a slot) and columns 4 to 7 are the parameters of the focused insert, four at a time. The page lists up to 272 inserts and rescans the folder only when its contents changed. A project names its inserts by id and name and not by list position, so adding or removing plugin files never changes which insert a project uses. The settings are saved with the project in a small plugins.txt next to it.
  • Mixer stage and Soft Knee. The first column of the Inserts page picks the stage that the track mixers run through before the inserts: Hard Clip, Soft Clip or the new Soft Knee. Soft Knee leaves everything below -3 dBFS untouched and rounds off the peaks above it. Soft Knee is also a new entry in the Saturation list. A project that uses it opens on older firmware with Hard Clip.
  • Dirt is now a plugin. The five built-in Dirt entries of 1.1.0 are gone from the Saturation list. Dirt is dirt.plg with Type, Drive, Bits, Rate, Tone and Mix. A project saved with a 1.1.0 Dirt entry opens with Dirt in insert 1 at the same values when dirt.plg is on the card.
  • Synth engines as plugins. Six engines are built in: ACD, FAT, VAP, WTFM, PERC and CHIP. The other twelve are plugins in /Plugins/Synth/: JU6, PHZ, FM4, D-Type, CS-Type, A-Type, T-Type, 8-Type, Hand-Type, B-Type, Arc-Type and PLK. They show up in the synth model list like any other engine, with their card logos. When the list rests on a plugin engine for half a second it is installed into the Tracker's data flash and the popup Loading <NAME> appears. A project load installs the engines it needs. The synth library takes as many plugins as the card holds, up to 249 engines. Engine numbers, patch files and slots are the same as in 1.1.0, so old projects and patches find their engines. A part whose engine file is not on the card shows Missing: <NAME> and keeps its settings. Hand-Type and PLK are new in this release. PLK is a plucked-string engine (Karplus-Strong). Besides the string settings it has Vel Bright, which makes louder notes brighter, and Body, which adds the resonances of a guitar body. Both start at 0, which is the plain string sound.
  • Synth Automation. The Params button now cycles three Synth pages: Synth Parameters, Synth Macros and Synth Automation. Each patch has four automation slots. A slot is Off, an LFO or an envelope, and it drives one engine parameter or one macro. Pick the slot in column 1 and the destination in column 2. An envelope has Attack, Decay, Sustain, Release and Amount. An LFO has Shape, Speed and Amount. The automation is saved in the .patch file of the open slot, so each of the 16 patch slots has its own. Patches without automation save exactly as before. Older tracker-ff firmware still loads a patch with automation, plays its sound without the automation and keeps the automation data when it saves the patch.
  • Lower audio CPU. The synth engines are compiled for speed and use faster floating point maths. Most engines need up to about 15 percent less audio CPU than in 1.1.0, which leaves more room for voices, inserts and automation.
  • Safe plugin loading. Before a plugin starts, the Tracker leaves a marker on the card. If a plugin ever crashes the Tracker, the next start loads no plugin by itself and the Inserts page names the one that crashed. Holding Shift during the first 4 seconds after power on does the same. Picking a plugin by hand still works.

Sample editor effects

Copy .ptfx files to /Effects/ on the SD card and they appear in the Sample Editor effect list. They run when you press Preview or Apply and cost no firmware space.

  • Transient Shaper with Attack and Sustain from -12 to +12 dB. At 0 and 0 the sample is left bit for bit as it was.
  • Six OpenTracker effects: Tape Saturation (Drive, Wow, Flutter, Mix), Lo-Fi Chip (Bits, Rate, Ladder, Speaker, Mix), Dirt Drive (Type, Drive, Bits, Rate, Tone, Mix), BBD Chorus (Mode, Tone, Mix, Tail), Dub Echo (Time, Fdbk, LowCut, Tone, Duck and Tail) and Reverb (Size, Damp, Predly, Diffus, Mix, Tail). Dub Echo, BBD Chorus and Reverb have a Tail option: Ring Out lets the echo or reverb die away past the end of the sample and Cut Off stops at the sample end.

Workflow

  • Add to Empty Slot. In the Sample Loader hold Shift over a file and the Add button turns into Add to Empty Slot. Press it and the sample goes into the first free instrument slot and the cursor moves there. With all 48 slots in use a popup says so and nothing is added. Without Shift, folders and multi-selection nothing changes.
  • Per-track MIDI-in. Config > MIDI has eight new items, Track 1 to Track 8 in channel, each Off or CH1 to CH16. In the pattern editor, notes on that channel play on the track's voice with the instrument last used on that track (instrument N for track N if there is none). Put several tracks on one channel for polyphony. Notes on a channel no track listens on behave as before. Existing settings are kept and the new items start Off.
  • Sample Loader memory modes. Samples now load into RAM by default. A Mode button in the Sample Loader switches a sample between RAM and streaming from the card and the import page has an Import Stream button.
  • After a project load the Tracker switches to the pattern editor instead of staying on the File screen. Load errors still stay on the File screen.

Fixes

  • Power off always switches the Tracker off. Before, it could hang at the end with the screen on and every key dead.
  • The main loop and the display use less stack. This closes a case where a deep synth plugin together with an insert could run past the end of the stack.
  • 8-Type and T-Type keep their working buffers out of the audio interrupt stack. Before, 8-Type playing while the Tracker wrote to the card could in the worst case run past the end of the stack. Their sound is unchanged.
  • Dirt returns silence for silent input at low bit depths and no longer pushes a DC step when it switches to Asym.
  • Project settings of the plugins survive a failed card write or a power cut during a save, and a save that cannot write them now reports an error.
  • Wavetable and granular position modulation clamps at 0 instead of jumping to the end of the sample.
  • Performance mode end point changes follow sequencer mode 2.
  • An unreadable folder on the card no longer breaks the firmware and sample file lists.
  • The folder list of the Sample Loader no longer overruns its list when a folder cannot be read. The folder shows as empty with /...
  • A corrupt .it module file can no longer overflow the stack on import.
  • An out of range audio connection index is rejected instead of writing one element past the input queue.
  • The playhead stays inside backward, ping-pong and granular loops that are shorter than one pitch step. Before, the note turned into noise.
  • Song blocks smaller than 32 steps copy and paste correctly.
  • Synth FX performance control works from MIDI CC.
  • The m/V and FX1/FX2 views of the pattern editor are easier to tell apart.
  • A volume and tune bug and a redundant FX reset in the audio sequencer are fixed. The display, LED and file transfer code is faster.
  • The CHIP engine no longer overloads the audio interrupt with many voices.
  • A short heap no longer makes an allocation return null into a write. Big synth blocks come from the external memory, so changing the engine of a synth part works on a full heap, and project load, recording save, folder lists and the synth editor value lists check the result.
  • The synth patch editor refuses a parameter or macro index outside the patch.
  • Taking a screenshot with Shift + Power after visiting the Synth Parameters page could crash the Tracker.
  • Changing the synth engine of a part repeatedly could crash the Tracker.

Known issues

  • The first time you pick a plugin engine, the Tracker copies it into its internal flash. In a busy project this can cause a short audio crack. Switching to an engine that is already loaded is silent.
  • Shift + Power screenshots can occasionally freeze the Tracker. Hold the power button to switch it off and on again.
  • The O - Patch step FX switches a part to the sound of another patch slot, but keeps the macros and the automation of the slot that is open on the Synth screen. To hear a slot with its own macros and automation, select it on the Synth screen.

One image

There is one .ptf: PolyendTracker_FF_1.2.0.ptf. The name has 27 characters and the bootloader reads at most 31, so do not rename it.

The synth engines and all twelve plugins are built for faster floating point maths, so use the plugin files from the zip with this image.

Credits

tracker-ff 1.2.0 includes work from several people. Thank you to:

  • Jordan Duncan for Add to Empty Slot (tracker-ce PR 58).
  • Scott Lepore for per-track MIDI-in (tracker-ce PR 51).
  • Emanuele Lapponi for Transient Shaper (tracker-ce PR 48).
  • Marcin Spoczynski for opentracker-fx (MIT). The Tape, Lo-Fi, Dirt, BBD and Phaser inserts and the Tape Saturation, Lo-Fi Chip, Dirt Drive, Dub Echo and BBD Chorus sample effects are ports of its modules. The BBD chorus DSP and the Lo-Fi ladder weights come from OpenTracker 3.x by sandlbn (Apache-2.0), and the Phaser uses two math routines from its va_dsp.h (Apache-2.0).
  • Emilie Gillet of Mutable Instruments for the reverb in the Reverb sample effect (MIT), adapted for Polyend's Polyverb by Wojciech Jakóbczyk.
  • Polyend and the tracker-ce contributors for everything underneath, including the changes from upstream in this release by Sandroid, Łukasz Langa and FatRodzianko.

The ports are rewritten in C for the Tracker and marked as modified in their source headers. Console and Tube are original designs of this project. Transient Shaper, Add to Empty Slot and per-track MIDI-in come from tracker-ce forks and keep the Polyend Tracker Community Edition license (MIT with the Wholesale Commercial Clone Restriction). The full texts are in the zip.

Made for the original Tracker

tracker-ff targets the original Polyend Tracker and nothing else. Every engine, plugin, the voice pool and the governor are tuned to fit its flash, RAM and CPU. The Tracker+ and the Mini already have Polyend's synths, so on those use upstream tracker-ce.

How to flash

  1. Back up your Projects/ folder first. Upstream CE saves patterns in a newer format that older firmware cannot read.
  2. Copy PolyendTracker_FF_1.2.0.ptf to the /Firmware folder on the microSD card. Keep exactly one visible .ptf file in that folder, and delete or move any other one.
  3. Copy the plugin files to the card. Synth engines (.plg and .plgi, file names up to 23 characters) go to /Plugins/Synth/ and inserts go to /Plugins/Master/. Without the engine files, projects that use JU6, PHZ, FM4, D-Type, CS-Type, A-Type, T-Type, 8-Type, Hand-Type, B-Type, Arc-Type or PLK show Missing on those parts. 1.1.0 had these engines built in, except Hand-Type and PLK, which are new.
  4. Optional: copy the .ptfx files to /Effects/.
  5. Put the card in the Tracker and open Config > Firmware > Firmware update. Select the file and confirm.
  6. Wait for the Tracker to flash and restart.

Do not rename the file. The original's bootloader lists only names that start with PolyendTrac and are at most 31 characters long.

If it does not boot

  1. Put a known good .ptf in /Firmware on the card, with no other .ptf there. Use the official Polyend firmware or the stock CE image.
  2. Insert the card and power the Tracker on.
  3. Press the recessed reset pinhole on the bottom of the Tracker with a paperclip or a SIM eject pin.

The hardware bootloader picks up the file from /Firmware and flashes it.

Go back to stock

Flash the official Polyend firmware or the stock CE .ptf the same way: copy it to /Firmware, then Config > Firmware > Firmware update and select it.

Files

  • PolyendTracker_FF_1.2.0.ptf is the firmware.
  • PolyendTracker_FF_1.2.0.zip has the firmware and the plugin files in one folder, PolyendTracker_FF_1.2.0/: Plugins/Synth/ with the twelve synth engine plugins and their logos (.plg, .plgi), Plugins/Master/ with the seven master insert plugins (.plg) and Effects/ with the fourteen .ptfx sample editor effects, including the seven new ones. It also has LICENSE, NOTICE.md, licenses/, SHA256SUMS and README-RELEASE.txt. Use it if you want to pass the firmware on, because the license asks you to ship LICENSE and NOTICE.md with it.
  • SHA256SUMS has the checksums of the firmware and the zip. The SHA256SUMS in the zip covers every file in it.

SHA-256 of the .ptf:

a165597f32f81d22a10012c7932906121214f60d0e8fad0b7f4958133ba39c70  PolyendTracker_FF_1.2.0.ptf

SHA-256 of the zip:

e1643b82ffa35de689b64143f00623d08ed99a193bfc9ad1549c56d5932e0ee6  PolyendTracker_FF_1.2.0.zip

Built from tag tracker-ff-v1.2.0 of https://github.com/sbialy/tracker-ff with Arm GNU Toolchain 12.3.rel1.

License

Free and non-commercial. MIT with upstream's Wholesale Commercial Clone Restriction: you can use, share and modify it for free, but you may not sell builds or clones of it. tracker-ff is not affiliated with or endorsed by Polyend. Full license texts for this project and every bundled third party component are in the zip (LICENSE, NOTICE.md, licenses/).

Source and build instructions: https://github.com/sbialy/tracker-ff