TrigOne Mini / Kboard 0.1.0
TrigOne Mini einrichten
Ein Drehgeber, ein Druckschalter und zwei Betriebsarten. Hier findest du die Einrichtung, alle fünf Kboard-Tabs und Hilfe für den Alltag.
01 / Erste Schritte
Verbinden und loslegen.
- Verbinde den TrigOne Mini mit einem USB-Datenkabel mit deinem Computer. Ein reines Ladekabel überträgt keine Daten. Ein fertig eingerichteter Controller benötigt für die normale Nutzung keine erneute Firmware-Installation.
- Lade Kboard für deinen Mac: Apple Silicon für einen Mac mit Apple-Chip, Intel für einen Intel-Mac. Öffne das DMG und ziehe die darin enthaltene App in den Programme-Ordner. Starte anschließend diese Kopie der App. Das DMG kopiert die App nicht automatisch.
- Wähle deinen Controller oben in Kboard aus. Fehlt er, verbinde ihn erneut und klicke auf Refresh. Die App-Oberfläche ist derzeit auf Englisch; die hier genannten Schaltflächen entsprechen deshalb ihren englischen Namen.
- Wähle unter Controller MIDI für MIDI-Zuordnungen oder HID für Mediensteuerung und Tastenkürzel. Prüfe deine Änderungen und übertrage sie mit Save to Controller.
Kboard 0.1.0 benötigt macOS 13 oder neuer. Die Downloads sind kostenlos und ohne Konto zugänglich. Ein Windows-Installer ist noch nicht veröffentlicht.
02 / Controller
MIDI: einen Parameter greifbar machen.
Wähle MIDI und ein passendes Preset. Rotate encoder legt die CC-Nummer des Drehgebers fest; Single press, Double press und Long press bestimmen die Druckaktionen. MIDI-CCs reichen von 0 bis 127, MIDI-Kanäle von 1 bis 16. Enabled schaltet eine Druckaktion ein oder aus.
Die Standardbelegung verwendet CC 7 für Drehen und CC 80 für einen einzelnen Druck auf Kanal 1. Das Beispielbild zeigt das Reaper-Volume-Preset auf Kanal 2. Aktiviere den MIDI-Eingang in deiner DAW und nutze deren MIDI-Learn-Funktion oder manuelle Zuordnung. Kanal und CC müssen zu deiner Software passen.
Encoder acceleration verstärkt schnelle Drehbewegungen. Der Regler ist ein Endlos-Drehgeber, kein Potentiometer mit festen Endanschlägen. Beginne beim Zuordnen von Lautstärke mit einem niedrigen Abhörpegel.
03 / Controller
HID: Medien und Tastenkürzel steuern.
Wähle HID. Für Drehen im und gegen den Uhrzeigersinn sowie die Druckaktionen kannst du Medienbefehle, No action oder Tastenkürzel auswählen. Shortcut… öffnet den Editor für Modifikatortasten und eine Taste; dort kannst du auch ein einzelnes Tastenkürzel erfassen.
Tastenkürzel gehen an die aktive Anwendung. Bringe zum Beispiel Apple Music in den Vordergrund, wenn du das Apple-Music-Preset verwendest. Medienbefehle wie Play / Pause werden vom Betriebssystem bzw. der aktiven Medienanwendung verarbeitet. Tastaturlayout und Anwendung können das Ergebnis beeinflussen.
Langer Druck: Moduswechsel oder Aktion
Mit Switch mode on long press wechselt ein langer Druck beim Loslassen zwischen MIDI und HID. Long press duration legt die Mindestdauer fest. In diesem Fall zeigt die lange Druckaktion Controller Mode Switch und sendet keinen zusätzlichen zugewiesenen Befehl. Deaktiviere diese Option, wenn der lange Druck eine eigene Aktion auslösen soll.
Live mode zeigt den vom Controller gemeldeten Modus. Die Auswahl im Editor kann davon abweichen, solange Änderungen noch nicht gespeichert sind. Ein physischer Moduswechsel und der gespeicherte Startmodus sind unterschiedliche Zustände.
04 / Deine Einstellungen
Presets vorbereiten. Änderungen bewusst speichern.
- Save As… erstellt ein eigenes lokales Preset, auch aus einem mitgelieferten Preset. Save aktualisiert ein eigenes Preset; Revert stellt dessen zuletzt geladenen oder gespeicherten Stand im Editor wieder her.
- More enthält Import und Export. MIDI- und HID-Presets werden getrennt verwaltet. Note speichert einen Hinweis zum Preset auf deinem Computer, nicht auf dem Controller.
- Save to Controller öffnet eine Übersicht der geänderten Einstellungen. Bestätige erst nach der Prüfung. Kboard validiert die Konfiguration, sichert den bisherigen Stand und prüft die zurückgelesenen Daten.
- Discard Changes verwirft den nicht gespeicherten Einstellungsentwurf. Das Speichern eines lokalen Presets allein ändert den Controller nicht.
05 / Für Fortgeschrittene
Firmware Code
Hier kannst du den tatsächlichen code.py-Inhalt des Controllers ansehen und bearbeiten. Reload from Device liest ihn erneut. Use Default lädt den mitgelieferten Quelltext in den Editor; Saved Code… lädt gespeicherten Code. Diese Schritte schreiben noch nichts auf das Gerät.
Save to Device ist der separate Schreibvorgang mit Vorschau, Sicherung und Bestätigung. Eine erfolgreiche Datenprüfung beweist bei eigenem Code noch nicht, dass er korrekt startet. Wenn der Controller bereits funktioniert, ist dieser Tab für die normale Konfiguration nicht nötig.
06 / Für Fortgeschrittene
Firmware Library
Verwalte mitgelieferten und lokal gespeicherten Firmware-Code. Open in Firmware Editor öffnet die Auswahl zur Ansicht oder Bearbeitung. Save Current Code, Import und Export verwalten deine Code-Bibliothek; das Übertragen auf das Gerät erfolgt separat im Firmware-Code-Tab.
07 / Basissoftware
Pico System
Dieser Tab prüft die Basissoftware und Bibliotheken unterhalb deines Controller-Codes. Kboard 0.1.0 enthält kein Pico-Systemupdate und keinen freigegebenen BOOTSEL-Wiederherstellungsablauf. No update currently available ist deshalb bei dieser Version normal. Formatiere das Controller-Laufwerk nicht zur Fehlerbehebung; wende dich bei einem nicht startenden Gerät an den Support.
08 / Verbindung und Integration
Kboard Settings & MCP
Kboard Settings zeigt den Verbindungszustand und die Anzahl erkannter Controller. Allow agent access (MCP server) schaltet die optionale lokale Agent-Anbindung frei. Für normale MIDI- und HID-Nutzung ist sie nicht erforderlich.
MCP für Codex und andere lokale Clients einrichten
Aktiviere die Agent-Anbindung in Kboard Settings. Verwende vorzugsweise den mitgelieferten kboard-mcp-Befehl über stdio. Das folgende Beispiel gilt für die Apple-Silicon-App im Programme-Ordner; passe den App-Namen an deine tatsächlich installierte Kopie an. Intel verwendet Kboard-x86_64.app.
[mcp_servers.kboard]
command = "/Applications/Kboard-arm64.app/Contents/Resources/kboard-mcp"
args = []Kboard verwendet die lokale Schlüsselbund-Anmeldung. Die alternative HTTP-Adresse in Settings ist nur lokal erreichbar und benötigt Authentifizierung; die URL allein reicht nicht. Kopiere keine Zugangsdaten in die Konfiguration. Agent-Zugriff erlaubt weder beliebige Shell-Befehle noch das Umgehen der Bestätigung bei Geräteänderungen.
09 / FAQ
Antworten für den Alltag.
Muss Kboard immer laufen?
Nein. Der eingerichtete Controller führt seine gespeicherte Konfiguration selbst aus. Kboard brauchst du, um Einstellungen zu ändern oder das Gerät zu prüfen.
Was ist im Paket?
Der TrigOne Mini, ein USB-Kabel und zwei unbeschriftete, magnetisch austauschbare Holzlabels. Holzmaserung und kleine handwerkliche Details unterscheiden sich je nach Exemplar.
Warum erscheint mein Controller nicht?
Prüfe, ob das Kabel Daten überträgt. Verbinde den Controller direkt mit dem Computer, versuche einen anderen USB-Port und klicke Refresh. Prüfe auch, ob der Controller als USB-Laufwerk erscheint. Bleibt er unsichtbar, kontaktiere den Support.
Warum reagiert meine DAW nicht?
Prüfe den Live-Modus MIDI, den aktivierten MIDI-Eingang und die Kanal-/CC-Zuordnung in der DAW. Eine Auswahl im Kboard-Editor allein ist noch keine gespeicherte Änderung.
Warum steuert HID die falsche App?
Tastenkürzel gehen an das Vordergrundprogramm. Aktiviere die gewünschte App und prüfe die Preset-Notiz. Verwende eine Medienaktion, wenn du eine passende systemweite Medienfunktion statt eines Tastenkürzels brauchst.
Warum ist Controller gesperrt?
Kboard erkennt möglicherweise abweichenden Firmware-Code. Prüfe zuerst Firmware Code. Eigene Firmware muss config.json unterstützen; ein manuelles Freigeben der Einstellungen ergänzt diese Unterstützung nicht automatisch.
Was mache ich nach einem unklaren Speicherfehler?
Wiederhole den Schreibvorgang nicht sofort. Kopiere die Statusmeldung, verbinde den Controller bei entsprechender Aufforderung neu und nutze Check Saved Code, falls angeboten. Kontaktiere den Support mit der Meldung.
Ist Kboard kostenlos und brauche ich ein Konto?
Kboard für Mac ist kostenlos und ohne Triggerpointed-Konto herunterladbar. Die optionale MCP-Anbindung ist für die normale Nutzung nicht erforderlich.
Gibt es eine Windows-App oder OSC?
Für Kboard 0.1.0 gibt es keinen veröffentlichten Windows-Installer. Die dokumentierte Controller-Konfiguration umfasst MIDI und HID; OSC wird hier nicht angeboten.
Wie pflege ich das Holz?
Trenne den Controller vor der Reinigung vom USB-Anschluss. Verwende ein weiches, trockenes Tuch und halte Flüssigkeiten, aggressive Reiniger und starke Hitze vom Holz und der Elektronik fern.
Noch eine Frage? Nenne uns deine Kboard-Version, dein Betriebssystem, die gewünschte Funktion und die genaue Statusmeldung. Support kontaktieren.