Skip to main content

Tools overview

Besides the firmware and PCB, the repo ships browser and CLI tools for samples, patterns, SD files, firmware flashing, and docs imagery.

Public / hosted​

ToolURLSource
Sample converteraudioconvert.tyng.appstandalone-tools/audio-converter-standalone/
SD toolsdtool.tyng.appstandalone-tools/sd-tool-standalone/
Browser simulatorsim.tyng.appstandalone-tools/web-standalone/
Firmware toolfirmware.tyng.apptools/teensyloader/ (GPL-3.0)
Color scheme editortoern.live/tools/colorsheme/tools/colorsheme/
Case generator (demo)toern.live/tools/case-generator/tools/case-generator/

Local / contributor helpers​

ToolPathRole
SD CLIstandalone-tools/sd-tool-standalone/toern_sd.pyScripted list/put/get over USB serial

How they relate to the device​

flowchart LR
WAV[WAVs / ZIPs] --> CONV[Sample converter]
CONV --> SD[microSD layout]
MID[MIDI file] --> SIM[Simulator]
HOST[Browser / CLI] --> SDTOOL[SD tool]
SDTOOL -->|ETC → SD serial| TEENSY[Teensy]
HEX[.hex firmware] --> LOADER[Firmware tool]
LOADER -->|WebHID| TEENSY

Operator-facing how-to stays in the handbook; these pages describe what each tool is, where the code lives, and how to run or extend it.

Next​

Shared visual design​

The firmware tool, sample converter and both SD browser views use tools/tool-theme.css: the website’s grey backgrounds, white surfaces, red actions and TŒRN font family (Bebas Neue, Space Grotesk, Inter, JetBrains Mono). Each independently hosted tool includes its own copy so it does not depend on the website’s CSS.

After editing the canonical theme, run from the repository root:

python3 tools/sync-tool-theme.py

Page-specific styles retain their functional layout. Keep input IDs and event bindings stable when changing presentation. The simulator approximates device audio/timing; its transfer feature does not transfer complete KIT sounds. See Browser simulator.