Skip to content

SaturnsGithubSaga/polyendtracker-midi-export-12-track

Repository files navigation

Polyend Tracker to MIDI Converter (12-Track / Chord FX Edition)

A specialized fork designed to run as a Docker container with a web interface. Translates Polyend Tracker project files (.mt) and pattern files (.mtp) into standard MIDI files (.mid).

Based on the original tool by DataGreed.

Background

Polyend Tracker firmware 1.9.0 introduced 4 additional dedicated MIDI tracks, bringing the total to 12. The upstream tool predates this and only handles the original 8-track payload structure.

This fork adds support for the 12-track payload format (0x2428 offsets) introduced in 1.9.0, reverse-engineered by cross-referencing known pattern data against .mtp hex output. It also fixes several crashes present in the original and adds a Docker-based web interface.

Key Features & Fixes

  • 12-Track & Legacy Support: Compatible with 1.9.0+ 12-track firmware payloads, with dynamic backward compatibility for legacy 8-track projects and mixed-firmware .mtp archives.
  • Polyphonic Chord FX Translation: Accurately parses internal Chord FX (Type ID 0x0E) and generates simultaneous multi-note MIDI arrays for correct polyphony.
  • Dynamic Naming Output: Strips the original .zip or .mtp extension and outputs a cleanly formatted [filename]_convertedmidi.zip.
  • Fix (FW 1.6+ Headers): Updated the file header check to support newer firmware payload sizes.
  • Fix (Orphan Note-Offs): Patched the midiutil library to prevent IndexError crashes caused by patterns starting with Note-Offs on all tracks — common in sample-choking tracking workflows.

Usage

Option 1: Docker (Recommended)

sudo docker build -t polyend_tracker_image .
sudo docker run -d -p 8501:8501 --name polyend_converter polyend_tracker_image

Access the web interface at http://localhost:8501. Upload your zipped project folder to generate and download the .mid conversions.

Option 2: Deploy to Cloud

Host for free on Render.com for personal use or sharing.

Deploy to Render

Credits & License

  • Original tool: DataGreed
  • Maintenance, Dockerization & 12-track reverse engineering: SaturnsGithubSaga
  • MTP hex structure documentation: docs/TRACKER_MTP_SPECS.md

This project is open-source and follows the license of the original repository.

About

A vibecoded evolution of the Polyend Tracker MIDI exporter. Now featuring universal 12-track support, polyphonic Chord FX translation, and legacy 8-track project compatibility. Docker-ready for Synology and Render.

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages