Der NerdyMidiMapper ist ein lokales Windows‑Tool zum MIDI Controller einlernen. Ziel ist es, physische Controls wie Buttons, Encoder, Fader, LEDs und sogar Motorfader sauber zu erkennen, zu benennen und als strukturierte JSON‑Datei zu speichern – damit sie später automatisiert verwendet werden können.
Der ursprüngliche Zweck: die perfekte Vorstufe für das kommende Projekt NerdyMidiActions. Gleichzeitig ist der NerdyMidiMapper aber bewusst so offen gebaut, dass du die erzeugten Mappings auch direkt in eigenen Tools, Skripten oder Automationen weiterverwenden kannst.
Alles läuft komplett lokal auf deinem PC, ohne Cloud, ohne Internet, ohne DAW‑Zwang.
Wofür eignet sich der NerdyMidiMapper?
Der NerdyMidiMapper ist kein klassischer MIDI‑Mapper für DAWs. Er ist ein Lern‑ und Testwerkzeug, das eine saubere technische Grundlage schafft, um MIDI‑Hardware programmatisch weiterzuverwenden.
Die Kernidee lautet:
Erst einlernen → strukturiert speichern → später automatisiert nutzen.
Typische Anwendungsfälle:
- Vorbereitung für NerdyMidiActions (kommt demnächst)
- Eigene Python‑, C#‑ oder Node‑Tools mit MIDI‑Eingaben
- Smart‑Home‑Trigger über MIDI
- StreamDeck‑ähnliche Setups mit echter Hardware
- Analyse unbekannter oder schlecht dokumentierter Controller
Was kann das Tool konkret?
Der NerdyMidiMapper erkennt eingehende MIDI‑Events und ordnet sie im Lernmodus einem logischen Namen zu. Dabei werden folgende Control‑Typen unterstützt:
- Buttons
- Encoder
- Fader
- JogWheels
- LEDs
- Motorfader
Zusätzlich lassen sich LED‑Feedbacks testen und Motorfader gezielt anfahren, um Wertebereiche, Velocity und Verhalten sauber zu überprüfen.
Die Ergebnisse werden automatisch als controls.json gespeichert – eine einfache, stabile Austauschbasis für spätere Automationen.
LED‑ & Motorfader‑Test direkt im Tool
Ein zentraler Bestandteil des NerdyMidiMapper ist der aktive Feedback‑Test:
- LEDs lassen sich direkt aus der Oberfläche an‑ und ausschalten
- Velocity‑Scans helfen beim Finden optimaler Helligkeitsstufen
- Motorfader können gezielt auf absolute Werte gefahren werden
Damit ist das Tool nicht nur zum Einlernen geeignet, sondern auch perfekt zur Funktionsprüfung von MIDI‑Hardware – besonders hilfreich bei gebrauchten Controllern.
JSON‑Format – bewusst einfach gehalten
Jedes eingelernte Control landet als eigener Eintrag in der Datei controls.json:
{
"DeviceKey": "X-Touch",
"DeviceMatch": "X-TOUCH",
"MidiType": "Note",
"Channel": 1,
"Number": 32,
"ControlType": "Button",
"LogicalName": "Play"
}
Dieses Format ist bewusst flach, stabil und sprachunabhängig gehalten, damit es problemlos in beliebigen Programmiersprachen weiterverarbeitet werden kann.
Für welche Hardware eignet sich der NerdyMidiMapper?
Grundsätzlich funktioniert der NerdyMidiMapper mit allen MIDI‑Controllern, die über Windows als MIDI‑Device erkannt werden – unabhängig vom Hersteller.
Besonders praktisch ist er z. B. für:
- Behringer X‑Touch (bezahlter Link)
- Akai APC Key 25 mk2 (bezahlter Link)
- Novation Launchpad (bezahlter Link)
- Korg nanoKONTROL (bezahlter Link)
Der große Vorteil: Auch exotische oder ältere Controller lassen sich vollständig durchleuchten und dokumentieren.
Installation & Start
Für Endnutzer gibt es eine fertige Windows‑EXE, die keinerlei Python‑Installation benötigt:
- Download als Ein‑Datei‑EXE über GitHub Releases
- Start per Doppelklick
- Die Weboberfläche öffnet sich automatisch unter:
http://127.0.0.1:5000
Die Datei controls.json wird automatisch im Programmverzeichnis angelegt.
Warum das Ganze die perfekte Vorstufe für NerdyMidiActions ist
Der NerdyMidiMapper ist bewusst als reine Lern‑ und Testschicht konzipiert. Er erzeugt saubere, reproduzierbare Mappings – ohne bereits Aktionen auszulösen.
Genau hier setzt das kommende Projekt an:
NerdyMidiActions wird diese JSON‑Mappings direkt einlesen und daraus echte Aktionen machen – z. B.:
- Programme starten
- Fenster verschieben
- Smart‑Home‑Aktionen auslösen
- OBS‑Szenen wechseln
- eigene Skripte feuern
Der Mapper ist also das Fundament, auf dem spätere MIDI‑Automation sauber aufbauen kann.
Download & Quellcode
- Fertige Windows‑Version (.exe):
https://github.com/GrayTheZebra/NerdyMidiMapper/releases - Quellcode auf GitHub:
https://github.com/GrayTheZebra/NerdyMidiMapper
Die Windows‑Version ist als Ein‑Datei‑EXE (onefile) gebaut – keine Installation notwendig.
Fazit
Der NerdyMidiMapper ist kein klassisches Musiker‑Tool, sondern ein technisches Brückenwerkzeug:
- Er macht MIDI‑Hardware maschinenlesbar
- Er trennt Lern‑Phase und Aktions‑Phase sauber
- Er bildet die Basis für zukünftige MIDI‑Automationen
Ob du ihn nur zur Dokumentation deiner Controller nutzt oder später tief in NerdyMidiActions integrierst – der Mapper sorgt dafür, dass dein MIDI‑Setup endlich strukturiert, reproduzierbar und automatisierbar wird.
🧪 Nächster Schritt:
Der passende Aktions‑Layer ist bereits in Arbeit. Mehr dazu bald hier auf prokrastinerd.de unter dem Namen NerdyMidiActions.
