Skip to content

bnjreece/awesome-te

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

15 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

awesome-te

A curated directory of reverse-engineering, custom firmware, tools, mods, and teardowns for Teenage Engineering gear.

Scope: real, working, TE-specific projects only. Curate, don't collect - see Contributing.

Status: 🟒 active Β· 🟑 dormant (works, but quiet) Β· πŸ”΄ archived (read-only). Everything listed is usable today - we don't list announced-but-unreleased projects.

Contents

SP-1 / Stem Player

Custom firmware & OS

  • 🟒 sp1-midi - Zephyr BSP/template that is the foundation for building custom SP-1 synths, MIDI controllers, or firmware.
  • 🟒 sp1-tape-looper - Four-track tape-machine looper firmware that ships a known-good recovery bin.
  • 🟒 marisko - Community custom firmware plus a ready-to-use Zephyr board definition for the SP-1.
  • 🟒 feldd - Turns the SP-1 into a USB, Bluetooth and TRS MIDI controller; map the faders and buttons to any CC or note from the browser, with per-control channels for a mixer.

Reverse engineering & docs

  • 🟒 SP-1-dev - The hub: GPIO pinout, bootloader protocol, eMMC notes, and a dev wiki for writing firmware.
  • 🟒 SP-1-knowledgebase-skill - Cited, curated SP-1 technical reference library packaged as a Claude agent skill.

Tools & software

  • 🟒 spire - Renode-based SP-1 emulator that tests firmware with zero brick risk before flashing.
  • 🟒 sp1-merge - CLI tool to encode and merge Demucs stems into an SP-1-compatible WAV.
  • 🟒 Stem Player Studio - Desktop app to manage the SP-1, including a host-side Python firmware flasher.
  • 🟒 SP-1 Utility - Native Mac app that converts songs or four-stem folders into SP-1 WAVs and uploads them over USB-C, no Terminal or Python needed.
  • 🟒 solderless.engineering - Web updater that loads custom stems and flashes firmware without opening the unit.
  • 🟒 yzy-stemplayer-reverse - PyUSB scripts that fuzz the Stem Player's USB vendor requests, DFU entry, and memory.

Teardown, flashing & recovery

  • 🟑 ESP32_nRF52840_glitch - ESP32 tool to read/write internal nRF52 flash over SWD/glitch, used for SP-1 recovery.

Community

TP-7

Reverse engineering & docs

  • 🟒 TP-7 guide: going deeper - Independent cheat-sheet decoding the TP-7's opaque UI, multitrack, loop and cue workflows.

Tools & software

  • 🟒 tp7-midi - Web app that documents the TP-7's quirky MIDI CC behavior while driving transport, loops and cues over Web MIDI/BLE.
  • 🟒 tp7-util - macOS app to split and combine TP-7 multitrack polyWAV stems for DAW workflows.
  • 🟒 TP-7-VoiceSync - macOS menu bar app that auto-syncs, transcribes and files TP-7 voice memos to Apple Notes.
  • 🟒 wavesync - Ruby CLI that converts a music library to TP-7 spec and syncs it to the device over MTP.

Teardown, flashing & recovery

  • 🟑 TP-7 Disassembly Tools - 3D-printable non-standard tools to open a TP-7, though the author warns disassembly likely bricks it.

Community

OP-XY

Reverse engineering & docs

  • 🟒 kmorrill/xy-format - Community reverse-engineering notes on the OP-XY .xy binary project format, the anchor reference for the scene.

Tools & software

OP-Z

Reverse engineering & docs

  • 🟒 libopz - Unofficial C++ library to parse .opz project files and talk to the OP-Z over MIDI/SysEx.
  • 🟑 z-po-project - Reverse-engineering wiki documenting OP-Z internals, the closest thing to a protocol bible.

Tools & software

  • 🟒 videolab - Official Unity toolset for building OP-Z videopaks, the foundation every custom videopak is built on.
  • 🟒 connect-opz - Lua script to wire the OP-Z in as an audio device on the monome norns.
  • 🟒 underbridge - Exports OP-Z patterns and projects to separate per-track audio folders for a DAW.
  • 🟒 OPZ_Bounce_Puller - Windows app that auto-transfers, renames, and clears .wav bounce files off the OP-Z.
  • 🟑 VideolabTest - Worked videolab shader/effect examples that show how to actually build a videopak.
  • 🟑 OP-Z-Videopak - Ready-made collection of OP-Z videopaks to drop in or learn from.
  • 🟑 op-z-m-vave-smk-25 - MIDI bindings that drive the OP-Z sequencer from a cheap M-Vave wireless controller.
  • 🟑 OPZgo - Python utility for ultra-portable OP-Z backups with no computer needed.
  • 🟒 OP-Z videopaks: Roman's collection, Chords UI, Tape Track FX.

Hardware mods

  • 🟑 OP-Z-Cube - Arduino-driven LED light object that reacts live to the OP-Z.

OP-1 / OP-1 field

Custom firmware & OS

  • 🟒 op1hacks - Primary GitHub org for OP-1 firmware hacking: repacker, docs, firmware archives, and preset tools.
  • 🟒 op1repacker - Unpacks, modifies, and repacks OP-1 firmware to unlock hidden iter synth, filter, and custom graphics mods.
  • 🟒 op1-fw-archive - Archive of (almost) all original OP-1 firmware versions for downgrade and research.
  • 🟒 op1REpackerGUI - Desktop GUI front-end for op1repacker, making OP-1 firmware mods accessible without the CLI.
  • πŸ”΄ op1-field-fw-archive - Archive of OP-1 field firmware releases with changelog notes, useful for downgrade and study.

Reverse engineering & docs

  • 🟒 op1-docs - Documentation and reverse-engineering research on OP-1 firmware and hardware internals.
  • 🟑 sowbug/op-1-tools - Reverse-engineering research and tooling on the OP-1's file formats and internals.

Tools & software

  • 🟒 op1.fun - Community hub to download and share 12,500+ patches, with an in-browser drum builder and macOS sync app.
  • 🟒 OP1GO - Ultraportable Raspberry Pi Zero backup appliance for the OP-1, no computer required.
  • 🟒 OP1field - Ableton Live 12 remote script giving the OP-1 Field transport, arm/mute/solo and navigation.
  • 🟒 op1-lfo-hero - Sends beat-synced LFO automation (pan/mute/volume) to the OP-1 Field over USB-C or BLE MIDI.
  • 🟑 Xfer Records OP-1 Drum Utility - Free Win/Mac plugin merging 24 one-shot samples into a valid OP-1 drumkit AIF file.
  • 🟑 operator1/op1 - Java utilities to split stereo and drumkits and pack samples into OP-1 drumkits.
  • 🟑 libop1 - Library plus CLI programs to manipulate AIFF files in OP-1's patch and sample format.
  • 🟑 OPluge - Converts OP-1 AIF patches to Synthstrom Deluge XML patch format.
  • 🟑 op1-drumkit-reader - Node.js library to extract JSON drumkit metadata embedded in OP-1 drumkit AIF files.
  • 🟑 blattm/op1tools - Adds short audio previews to OP-1 patches by round-tripping them through the device over USB.

Teardown, flashing & recovery

  • 🟒 iFixit OP-1 repair guides - Eight step-by-step teardown/repair guides: battery, display, keyboard, connector board, flex cable.
  • 🟑 op1dumps - Flash/OTP dumps, schematic, and bootloader for replacing a dead OP-1 processor or flash chip.

EP-133 K.O. II / EP-1320

Reverse engineering & docs

  • 🟒 KOII-tips-and-tricks - Community-compiled guide of K.O. II tips and tricks distilled from Elektronauts forum threads.
  • 🟑 ep_133_sysex_thingy - Reverse-engineered SysEx command library and docs to manage K.O. II samples without the official tool.

Tools & software

  • 🟒 ep133-export-to-daw - Reverse-engineered WebMIDI tool exporting full K.O. II projects to Ableton, REAPER, DAWproject, and MIDI; hosted at ep133-to-daw.cc.
  • 🟒 mcp-koii - MCP server controlling the K.O. II over MIDI so an LLM can play notes and patterns.
  • 🟒 ep133-krate - CLI and terminal-UI sample manager built on a reverse-engineered SysEx protocol.
  • 🟒 knockout - Electron desktop sample manager that imports WAVs and exports .ppak projects and .pak backups.
  • 🟒 ep133-ppak - Python library and CLI to write valid .ppak sample-mode and song-mode project files from JSON.
  • 🟒 Cornerman for K.O. II - iOS app that backs up the K.O. II offline, without TE's web tool.
  • 🟒 EP Toolkit - Native EP-133/1320/40 app: project export to DAWs, full sample management, CLAP processing, and device backups.
  • 🟒 AudioBatchConverter - Batch-prepares audio samples for the K.O. II and exports sample chains for the PO-33.
  • 🟒 EP-PatchStudio - Rust desktop app for EP-133/1320/40: device management, multisample editor, MIDI auto-sampler, and audio editing; pay-what-you-want.
  • πŸ”΄ ep_133_sample_tool - Offline fork of the EP sample tool adding projects-only backup and raw SysEx debugging.

EP-2350 Ting FX

Reverse engineering, Docs, & Examples

  • 🟒 open-ting - MicroPython and Binary dumps, docs, and drag-and-drop examples for advanced features out of the box.

Pocket Operators

Custom firmware & OS

Tools & software

  • 🟒 po-33 - Clean browser drag-and-drop loader that records sample banks into the PO-33 K.O.
  • 🟑 Pocket Operator simulator - In-browser JavaScript emulation of the PO-20 drum machine with a working sequencer.

Hardware mods

TX-6

Reverse engineering & docs

  • 🟑 tx-6-midi-events - Reverse-engineered TX-6 BLE MIDI event map plus a connect.js that logs live events.

Tools & software

  • 🟒 tx6 (web remote) - Live web PWA remote controlling the TX-6 over Web MIDI (BLE and USB), with an LFO engine.

OD-11 / Ortho Remote

Reverse engineering & docs

  • πŸ”΄ node-od11 - TypeScript Node library to interface with and control the OD-11 cloud speaker.

Tools & software

  • 🟒 OD11-remote - Node app controlling OD-11 volume via a Senic Nuimo BLE controller over its WebSocket API.
  • 🟒 ortho-remote-mac - macOS tool mapping the Ortho Remote knob to volume, play/pause, and Spotify navigation.

Cross-device tools

Tools & software

  • 🟒 teoperator - Turns any audio file into OP-1 and OP-Z drum and synth patches, with a hosted version.
  • 🟒 DigiChain - Builds and splits sample chains and kits for OP-1 Field, OP-Z, and OP-XY in the browser.
  • 🟒 OP-PatchStudio - Open-source web app to build drum and multisample presets for both OP-XY and OP-1.
  • 🟒 OP_Manager - Raspberry Pi Zero handheld file manager for on-the-go backup and upload of OP-1/OP-Z patches.
  • 🟒 OP-1Z-Sample-Manager - Cross-platform desktop app for managing OP-Z and OP-1 samples.
  • 🟒 TEKit - Swift package controlling TE devices (OP-Z/TP-7/OB-4/OD-11) over BLE, USB, and WebSocket.
  • 🟒 field-remote - SwiftUI iOS BLE MIDI remote for TE field gear, with control panels for TX-6 and TP-7.
  • 🟒 MTVP - Free iOS app that plays video locked to your OP synths' MIDI transport and timecode.
  • 🟑 op-patch-util - Rust CLI to create and modify OP-1 and OP-Z drum patches, pitch, and metadata.
  • 🟑 mezmer - Live sound visualizer that works with both OP-Z and OP-XY.

Hardware mods

  • 🟒 TEcases - Handmade protective cases sold for OP-1 field, OP-XY, EP-series, TP-7, TX-6, Pocket Operators, and OB-4.

Community

  • 🟒 op-forums.com - The primary active TE community forum and the hub where most firmware and tool research starts.

Credits & inspiration

This directory exists because a few people did the hard reverse engineering and documented it carefully. Particular thanks to:

...and every contributor named throughout the linked projects.

Contributing

Found something missing or stale? See CONTRIBUTING.md - one-line entries, honest status, curate don't collect. Dead links are caught weekly by the link-check workflow.

License

To the extent possible under law, contributors have waived all copyright and related rights to this work under CC0 1.0 Universal.

Last reviewed: 2026-06-15.

About

A curated directory of reverse-engineering, custom firmware, tools, mods, and teardowns for Teenage Engineering gear.

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors