Werkzeugkasten

🎙️ Der Anwendungsfall, aus dem dictUSB entstanden ist

Auf einem MacBook läuft eine lokale Diktiersoftware – schnell, präzise, und die Sprache verlässt das Gerät nie. Im Bestand stehen aber auch Windows- und Linux-Rechner, die dafür zu knapp ausgestattet sind: zu wenig Leistung für lokale Spracherkennung, oder die Programme sind auf den anderen Betriebssystemen so nicht verfügbar.

Mit dictUSB diktiert man einfach am MacBook weiter – und der Text erscheint auf dem anderen Rechner, als würde ihn dort jemand auf einer angeschlossenen Tastatur eintippen. Der Zielrechner braucht dafür nichts: keine Installation, keine Treiber, keine Adminrechte, keine Cloud. Er sieht nur eine USB-Tastatur.

Dasselbe Prinzip trägt weiter als nur Diktat: Lange Konfigurationszeilen auf Server tippen (funktioniert sogar im BIOS und am Anmeldebildschirm), Textbausteine auf einen Zweitrechner schicken, oder einen Rechner fernbedienen, auf dem keine Fernwartung möglich ist.

⚙️ Wie es funktioniert

💻

Sender macOS · Windows · Linux — die dictUSB-App

WLAN, TCP – Ende-zu-Ende verschlüsselt (DICTUSB2)

Raspberry Pi Pico 2 W oder ESP32-S3 ~10 € — steckt per USB am Zielrechner

USB – meldet sich als ganz normale HID-Tastatur

🖥️

Zielrechner Windows / Linux — auch BIOS, Login-Screen, TTY

1. Der Mikrocontroller steckt per USB am Zielrechner – Strom und Tastatur-Anschluss in einem. Er verbindet sich mit dem WLAN.
2. Die dictUSB-App auf dem Sender (macOS, Windows oder Linux) verbindet sich per WLAN mit dem Mikrocontroller.
3. Was man in der App tippt, einfügt oder diktiert, tippt der Mikrocontroller auf dem Zielrechner – Zeichen für Zeichen, wie eine echte Tastatur.

Weil auf dem Zielrechner keine Software läuft, funktioniert es überall gleich: in jedem Programm, im Terminal, auf der Textkonsole, im BIOS-Setup und am Anmeldebildschirm – ganz ohne Rechte auf dem Zielsystem. Die einzige Konsequenz daraus: Der Zielrechner interpretiert die Tastendrücke nach seiner Tastaturbelegung; die wird deshalb einmal am Gerät eingestellt (deutsch ist Standard, weitere Layouts möglich).

📱 Die App

Ein Sender-Client für macOS, Windows und Linux (Flutter), als fertiger Download.

• Blockmodus: Text in Ruhe eingeben oder diktieren, prüfen, dann als Ganzes senden. Ideal für Diktat: erst wenn der Text stimmt, geht er raus.
• Direktmodus: jeder Tastendruck geht sofort an den Zielrechner – die App wird zur Fernbedienung inklusive Tastenkombinationen (Strg+…, Alt+…, Windows-Taste). Modifier-Mapping konfigurierbar, auf dem Mac ist Cmd→Strg vorbelegt.
• Diktat-Integration: Ergebnisse lokaler Diktiersoftware (getestet mit Paraspeech) landen direkt im Textfeld bzw. gehen im Direktmodus sofort ans Ziel.
• Textbausteine (Snippets): häufige Texte per Klick oder Hotkey (Cmd/Strg+1…9) einfügen bzw. senden.
• Mehrere Geräte: Geräteliste mit eigenem Token je Gerät, Umschalten per Dropdown.

Für macOS/Linux gibt es zusätzlich einen Python-Kommandozeilen-Client (auch für Pipes: echo 'Hallo' | dictusb.py 192.168.0.50) – Details im GitHub-README.

⬇️ Downloads

Fertige Builds gibt es auf GitHub: github.com/stwaidele/dictusb/releases/latest

Jedes Release enthält eine SHA256SUMS zum Prüfen der Downloads (shasum -a 256 -c SHA256SUMS).

Hinweise zum ersten Start

• macOS: Das DMG ist mit einer Apple-Developer-ID signiert und notarisiert und startet ohne Warnung. Beim allerersten Öffnen fragt macOS wie bei jeder geladenen App einmal nach – das ist normal. Falls macOS doch blockt (z. B. bei einem Prerelease): Rechtsklick auf die App → „Öffnen".
• Windows: Die App ist nicht signiert (ein Zertifikat kostet laufend Geld; die Prüfsumme ersetzt es). Beim ersten Start warnt Microsoft SmartScreen, weil es die App noch nicht kennt: „Weitere Informationen" → „Trotzdem ausführen". Wer sichergehen will, vergleicht vorher die Prüfsumme mit der SHA256SUMS aus dem Release.
• Linux: Archiv entpacken (legt ein Verzeichnis dictUSB/ an), dann ./dictUSB/dictUSB starten. Das Starter-Script legt beim ersten Start automatisch den Menü-/Dock-Eintrag an (.desktop-Datei) und aktualisiert ihn, wenn der Ordner später verschoben wird. Voraussetzung: GTK 3.

🔌 Hardware: Was man braucht

Genau ein Board (beide laufen mit identischer Firmware) plus ein USB-Datenkabel – Gesamtkosten unter 15 €:

* Affiliate-Links (Werbung): Ein Kauf darüber unterstützt das Projekt und kostet dich nichts extra. Die Boards gibt es genauso bei BerryBase, Reichelt & Co. – jedes ESP32-S3-DevKitC-1-Derivat mit nativem USB-Anschluss funktioniert. Die verlinkten Kabel sind Beispiele – jedes Datenkabel mit passendem Stecker funktioniert.

Einrichtung in Kürze (ausführlich im README): CircuitPython flashen (Datei aufs Laufwerk kopieren – kein Löt- oder Programmierwissen nötig), dictUSB-Firmware und Tastatur-Layout dazu, WLAN-Zugangsdaten und ein Token in die settings.toml – einstecken, fertig. Die Status-LED auf dem Pico/ESP32 zeigt den Zustand (bereit / verbunden / Tastendruck / Abbruch).

❓ Häufige Fragen