Skip to content

dadamachines/ctag-tbd

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,043 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dadamachines TBD-16

The first standalone desktop audio DSP platform based on CTAG TBD, with standard MIDI connectivity — designed to bring open-source audio processing beyond Eurorack.

TBD-16 combines 50+ high-quality generators and effects in a modular, extensible architecture. It is built for musicians, educators, and audio researchers who want hands-on DSP without proprietary lock-in.

Documentation

dadamachines.github.io/ctag-tbd

What This Fork Does

This repository is a fork of ctag-fh-kiel/ctag-tbd (branch p4_main), adapted for the dadamachines TBD-16 hardware. Our focus:

  • UI/UX — Redesigned web interface with musician-friendly interaction patterns
  • Documentation — Clear guides, example workflows, and UX guidelines for plugin developers
  • Desktop Hardware — Standalone form factor with standard MIDI, no Eurorack required

The DSP engine, plugin system, and core firmware are developed upstream by Robert Manzke / CTAG.

Getting Started

See the documentation for setup guides, plugin reference, and flashing instructions.

Hardware Configurations

The firmware supports four hardware configurations for different board variants — from a minimal flash-only build to the full TBD-16 with SD card and RP2350 sequencer bridge. See HARDWARE_CONFIGURATIONS.md for the feature matrix, build instructions, and Kconfig flag reference.

Project Structure

components/         DSP plugins and sound processors
docs/               Sphinx documentation source
main/               Firmware entry point and system management
sdcard_image/       Web UI and configuration data
simulator/          Desktop simulator for plugin development
sample_rom/         Stock audio samples
generators/         Plugin scaffolding templates

Building Documentation Locally

To build and preview the documentation (including the blog) on your local machine:

  1. Install requirements:

    pip install -r docs/requirements.txt
  2. Build HTML:

    sphinx-build -b html -c docs/config docs build/docs
  3. View: Open build/docs/index.html in your browser.

Community & Support

Contributing

Contributions are welcome — see CONTRIBUTING.md for the full guide covering the branch model, CI pipelines, build instructions, and artifact naming conventions.

Acknowledgements

CTAG TBD was created by Robert Manzke at the Creative Technologies Arbeitsgruppe, Kiel University of Applied Sciences.

The TBD-16 adaptation is led by dadamachines.

UX and instrument design contributions by Benjamin Weiss / instrument-design.

Funding

This project is partially funded through the NGI0 Commons Fund, established by NLnet with financial support from the European Commission's Next Generation Internet programme, under grant agreement No 101135429.

Not all work on TBD / TBD-16 is covered by NLnet funding.

NLnet

License

This repository contains code under two open-source software licenses:

Core DSP Engine (upstream ctag-fh-kiel/ctag-tbd) -- GNU General Public License (GPL 3.0). The audio engine, sound processors, and platform core. Modifications must be released under the same terms.

dadamachines Additions (web UI, browser-based flasher, plugins, documentation, tools) -- GNU Lesser General Public License (LGPL 3.0). Individual developers can freely use and contribute without copyleft affecting their own unrelated code. Companies must share modifications back or obtain a commercial license.

TBD-Core & TBD-16 Hardware -- The dadamachines TBD-16 (desktop instrument) and TBD-Core (core DSP board for custom products) hardware designs are proprietary.

Planned Open-Hardware Core Design -- An open-hardware core design based on the same ESP32-P4 + RP2350 platform is planned for future publication in KiCad as an open-source reference.

Original CTAG Hardware (V1/V2) -- Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0).

Copyright (c) 2020-2026 Robert Manzke. All rights reserved. (CTAG TBD core)

Copyright (c) 2014-2026 Johannes Elias Lohbihler for dadamachines. (TBD-16 adaptation, UI/UX, and Documentation)

See LICENSE for full details including trademark and commercial use terms.

About

A Fork of CTAG TBD (ESP32 audio DSP platform) with many changes and lots of UI/UX + docs changes for the dadamachines TBD‑16.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • C++ 57.3%
  • JavaScript 28.2%
  • HTML 4.3%
  • C 3.7%
  • Python 3.2%
  • CSS 1.9%
  • Other 1.4%