Hör auf zu tippen: Taste halten, reden.

Du installierst mir Handy (github.com/cjpais/Handy), eine kostenlose Open-Source-App, mit der ich per Tastenkürzel diktiere und der Text direkt da landet, wo mein Cursor steht. Die Spracherkennung läuft komplett lokal. Arbeite Schritt für Schritt und sag mir nach jedem Schritt in einem Satz, was passiert ist. Alles, was ich selbst klicken muss, sagst du mir als konkreten Handgriff.

Schritt 1, System erkennen: Prüf, ob ich auf macOS, Windows oder Linux bin. Auf Linux prüf zusätzlich, ob X11 oder Wayland läuft (echo $XDG_SESSION_TYPE) und welche Distribution.

Schritt 2, Installation:
- macOS: Wenn Homebrew da ist: brew install --cask handy. Sonst gib mir den Link https://handy.computer zum Download.
- Windows: winget install cjpais.Handy. Ohne winget: Download über https://handy.computer.
- Debian/Ubuntu: Lade die neueste .deb von https://github.com/cjpais/Handy/releases und installier sie mit sudo apt install ./Handy_*.deb (nicht dpkg -i, sonst fehlen Abhängigkeiten).
- Andere Linux-Distributionen: nimm das passende Paket von der Releases-Seite.
Hinweis an mich: Homebrew-Cask und winget-Paket pflegen nicht die Handy-Entwickler selbst.

Schritt 3, nur Linux, Texteingabe: Installier das Werkzeug, mit dem Handy den Text einfügt:
- X11: sudo apt install xdotool
- Wayland: sudo apt install wtype (auf Ubuntu 26.04 funktioniert wtype nicht, dann ydotool laut README einrichten)
Startet Handy mit dem Fehler libgtk-layer-shell.so.0, installier libgtk-layer-shell0 (Ubuntu/Debian), gtk-layer-shell (Fedora/Arch).

Schritt 4, erster Start: Starte Handy. Sag mir dann genau, welche Rechte ich erlauben muss: Mikrofon und Bedienungshilfen (auf dem Mac unter Systemeinstellungen > Datenschutz & Sicherheit). Diese Klicks mache ich, nicht du. Warte, bis ich „fertig“ schreibe.

Schritt 5, Modell und Kürzel: Sag mir, dass ich in Handy einmal ein Modell laden muss (Parakeet V3 läuft gut auf der CPU und erkennt die Sprache automatisch; Whisper Small bis Large nutzt die Grafikkarte, falls vorhanden). Dann soll ich in den Einstellungen mein Tastenkürzel festlegen. Wichtig auf dem Mac: Kürzel mit der fn-Taste funktionieren nur auf Apple-Tastaturen. Nutze ich eine fremde Tastatur, empfiehl mir ein Kürzel aus ctrl, option, shift oder command.

Schritt 6, Test: Bitte mich, ein Textfeld zu öffnen (Notizen, Mail oder dieses Chatfenster), das Kürzel zu halten, einen Satz auf Deutsch zu sprechen und loszulassen. Frag mich, ob der Text richtig angekommen ist. Wenn die Erkennung schwach ist, schlag mir vor, ein anderes Modell zu testen.

Schritt 7, Fehlersuche, falls nichts eingefügt wird:
- Rechte für Mikrofon und Bedienungshilfen nochmal prüfen.
- Bluetooth-Headset am Mac: Mikrofon in Handy auf das eingebaute oder ein externes Mikro stellen, Kopfhörer nur zur Ausgabe.
- Linux: Ist xdotool bzw. wtype installiert? Auf Wayland globale Kürzel über die Desktop-Einstellungen anlegen und als Befehl handy --toggle-transcription eintragen.

Zum Schluss: Fass mir in drei Zeilen zusammen, welches Modell und welches Kürzel ich jetzt nutze und wie ich Handy beim Systemstart automatisch starte (handy --start-hidden).