Skip to content

tracker-ff 1.3.0

Choose a tag to compare

@sbialy sbialy released this 13 Nov 12:00
· 3 commits to main since this release

tracker-ff 1.3.0

Even if you skip every new feature, tracker-ff 1.3.0 takes about 30 % less audio CPU than CE on any project CE can play. USB audio is built in. tracker-ff is unofficial community firmware for the original Polyend Tracker, built on Polyend's open source tracker-ce. It is free, non-commercial and not affiliated with Polyend. Version 1.3.0 adds a Features page with USB audio, moves CHIP onto the card as a plugin, lets you hide and reorder the engine list, adds the Glue insert and brings a long list of audio CPU savings.

New to the chord and macro features? The user guide explains macro depth, paraphony, chord capture, record join and Strum. The Synth order guide explains how to hide and reorder engines.

Updating from 1.1.0 or 1.2.0? Read the upgrade guide first. It is also in the zip as tracker-ff/UPGRADING.md. The short version for 1.2.0: unzip the whole zip onto the card, because CHIP is a plugin now and needs chip.plg, then flash.

What is new in 1.3.0

  • USB audio. Built in. Switched on, the unit shows up as an audio input on a computer after the next start. Switched off, it presents only the stock USB interfaces.
  • Glue master insert. glue.plg, a bus compressor with Auto makeup and a Character setting: Clean, Glue, Smooth, Punch or Colour. Makeup reads Auto at the bottom step. There are eight inserts now. Glue and Phaser do not fit the insert memory together, the second of the two shows Full.
  • Paraphony. A synth plugin can now answer a chord query of the firmware, an optional extension of the plugin format that leaves older plugins alone. ACD is the one engine of this release that does. It has three new parameters at the end of its Voice section, Chord Mode (Poly or Para), Chord and Strum, stored per patch. In Para a MIDI Chord step plays its notes as one voice through one filter and one set of envelopes, which costs less audio CPU than a voice per note. Patches from 1.2.x load with Poly and sound as before. The patch Chord plays for notes from the pads, a MIDI keyboard and plain steps, and a MIDI Chord step FX wins for its own step (the same goes for Strum).
  • Chord capture. Play MIDI keys together with the cursor on a step in any column, or hold pads with the cursor on a MIDI Chord cell, and the Tracker writes the chord into the step. A popup at the cursor shows the chord name and the held notes. A ~ before the name marks a near match. One Undo takes the chord back. The title bar and the popup show the chord with its root and bass such as Fmaj7/C, and the Fill list shows the name without a root such as maj7 inv2. MIDI Chord values above 29 (the inversions) play only the bass note on stock firmware, so a project with captured inversions sounds thinner there.
  • Strum FX. u - Strum next to a MIDI Chord starts the chord notes one after another, upwards for 1 to 63 and downwards for 65 to 127, 2 ms apart per unit. The notes start on audio blocks, so +10 is about 20 ms. A Para ACD patch strums inside its voice.
  • Record join. Notes you play together while recording are written as one step with a MIDI Chord. With several tracks armed the chord joins onto the track under the cursor.
  • Synth order. Shift + F1 on the Model column of the Synth screen opens an edit mode for the engine list. Shift + Up and Down move an engine, Delete hides it and Insert shows it again. The order is saved in /Plugins/synth-order.txt. Projects and .patch files are not affected, an engine that the open project plays still shows at the top even when hidden.
  • Macro depth Scale. A new patch scales a macro amount to the room between the parameter value and its end, so an Amount of 1.00 reaches the maximum and -1.00 the minimum. The Amount is shown from -2.00 to 2.00, and 1.00 is 100 %. Patches from 1.2.x keep the old rule. The mode is stored per patch. The unit has no row to switch it yet.
  • Features page. Config > Features lists the options that need a restart or a switch of their own. Each one has a State row and a page with its settings, kept in /Features/ on the card. A feature that needs a restart offers Restart now. The page lists USB audio and Chord names. Reset config clears the folder.
  • Note-on admission. A synth note whose estimated cost would push the audio block over its time budget starts at the start of the next block. It is at most one block late and never dropped. A voice that a new note takes over fades out in the block of the note.
  • Sample input chain idles. The USB input stream of the original sends no data, and a gate whose mixer inputs are silenced builds no output block, so an unused input chain costs less audio CPU. The output is unchanged.
  • CHIP is an installable engine. CHIP is chip.plg in /Plugins/Synth/, one of the thirteen plugin engines. The sound, the parameters and the numbers are unchanged, so old projects and .patch files open on it as before. It frees about 15 KB of flash. A CHIP part shows Missing: CHIP on a card without the plugin and keeps its settings.
  • Patch FX applies macros and automation. O - Patch now applies the macros and the automation of the slot it switches to, together with its values. An LFO or envelope that sits on the same slot type in both patches keeps running, one that changes type starts new.
  • Model list rest. Every step onto another engine in the Model list waits 1 s on the engine before it is loaded, built-in engines included, so scrolling does not pick every engine on the way.
  • Lower audio CPU. The short delay runs only the lines of the mode that is on. The reverb loop runs at half rate with the same room size, damping and decay time and lives in internal SRAM, so its 32 KB SDRAM buffer is gone. The limiter, the sample voice loops and the sequencer clock are cheaper. All of these give the same output bit for bit, except the delay mode switch below.
  • Master insert 2 runs from internal memory. Both inserts run from one 8 KB SRAM slot, so insert 2 no longer writes to the data flash. A plugin that fits alone but not beside the other shows Full:<name> and loads when the other leaves room. The synth plugin bank takes the two freed sectors.
  • Short delay mode switch. Switching between mono and ping pong with echoes ringing crossfades over about 90 ms and carries the echoes over. Before, it cut to unrelated echoes with a click.

Sample editor effects

  • Transient Shaper has new envelope times, and its Sustain gain is held back while a hit is rising.
  • Fourteen .ptfx effects in all, in /Effects/. The unzip replaces your old ones.

Workflow

  • Add to Empty Slot. With files selected in the Sample Loader, Shift with the add button adds the selection and does not jump to the first empty slot. After a jump the instrument list and the memory bar refresh.

Fixes

  • Installing a synth plugin into the data flash no longer makes the audio crackle. The audio output renders ahead into a deeper buffer while the flash erases, and the erase works in short slices.
  • The delay feedback and the reverb damping start the same way a project load sets them.
  • The master inserts of a project load wait like the synth engines do, so a project with inserts opens without a stall.
  • A part whose engine is not on the card (for example CHIP without chip.plg) keeps that engine. Its Model list shows the not installed popup and changes nothing. Before, one encoder click turned the part into ACD.

Known issues

  • A patch saved by 1.3.0 with a macro amount in Scale mode plays with the old Add rule on 1.2.x, so that macro sounds different there.
  • Macro depth mode cannot be switched on the unit yet.
  • Glue and Phaser do not fit together. The second of the two insert slots shows Full and passes the audio.
  • A part whose engine is missing (for example CHIP without chip.plg) still opens its Macros and Automation pages. Edits there are not kept.
  • 1.2.0 keeps at most 768 bytes of patch data it does not know. A patch saved by 1.3.0 with more than 765 bytes of such data does not load on 1.2.0. Normal patches carry 8 to 52 bytes.
  • The first time you pick a plugin engine, the Tracker copies it into its internal flash. In a busy project this can still cause a short audio gap, much shorter than in 1.2.0. 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.

One download

The release is the zip. The firmware image PolyendTracker_FF_1.3.0.ptf is inside it under Firmware/. The name has 27 characters and the bootloader reads at most 31, so do not rename it. The plugin files in the zip belong to this image.

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. Unzip the whole PolyendTracker_FF_1.3.0.zip onto the root of the microSD card. It has no wrapper folder: Firmware/, Plugins/Synth/, Plugins/Master/ and Effects/ are laid out like the card.
  3. Put the card in the Tracker and open Config > Firmware > Firmware update. Select PolyendTracker_FF_1.3.0.ptf and confirm.
  4. Wait for the Tracker to flash and restart. Config > Info > About then says tracker-ff 1.3.0.

Without the plugin files from the zip, projects that use a plugin engine show Missing on those parts. Do not rename the .ptf.

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 1.2.0 or stock

Flash the .ptf of tracker-ff 1.2.0, the official Polyend firmware or the stock CE .ptf the same way. Projects saved by 1.3.0 open on 1.2.0, see the upgrade guide for what plays differently.

Files

  • PolyendTracker_FF_1.3.0.zip is the release. It unzips onto the card root: Firmware/ with the image, Plugins/Synth/ with the thirteen synth engine plugins and their logos (.plg, .plgi), Plugins/Master/ with the eight master insert plugins (.plg) and Effects/ with the fourteen .ptfx sample editor effects. The folder tracker-ff/ holds LICENSE, NOTICE.md, UPGRADING.md, licenses/ and SHA256SUMS, and README-RELEASE.txt sits at the root. The license asks you to ship LICENSE and NOTICE.md with the firmware when you pass it on, so pass on the whole zip.
  • SHA256SUMS has the checksum of the zip. The one in the zip covers every file in it, the image included, and is checked from the card root with shasum -a 256 -c tracker-ff/SHA256SUMS.

SHA-256 of the zip:

31ea75416a9f6a68018105e443ec7e51f93642510a5655667ca4f0568ea7e464  PolyendTracker_FF_1.3.0.zip

Credits

tracker-ff 1.3.0 builds on 1.2.0 and 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) and opentracker-synths (MIT). The Tape, Lo-Fi, Dirt, BBD and Phaser inserts and several 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).
  • 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.

Console, Tube and Glue are original designs of this project. The full license texts are in the zip.

ACD, FAT, VAP, WTFM, PERC and PHZ are the names Polyend gives its own synth engines. They are used here only to say which engine a slot is modelled on. The engines in this firmware are not Polyend's code, and tracker-ff is not affiliated with or endorsed by Polyend.