Haki (حكي): Push-to-Talk-Diktat für die Mac-Menüleiste, auf Arabisch abgestimmt

Was ist Haki?

Haki (حكي, ein levantinisch-arabisches Wort für „Sprechen“) ist eine leichte native macOS-Menüleisten-App für Sprache-zu-Text-Diktat. Klicke in ein beliebiges Textfeld in einer beliebigen App, halte die Push-to-Talk-Taste, sprich und lass los. Haki transkribiert, was du gesagt hast, und fügt es am Cursor ein. Der arabische Slogan lautet „احكي، وحكي بيكتبها“, etwa „du sprichst, Haki schreibt“.

Es ist besonders für natürliches Arabisch und levantinisches Sprechen gedacht, mit Unterstützung für Englisch, Deutsch, Französisch und automatische Spracherkennung. Es hat kein lokales Sprachmodell und keine Python- oder Node.js-Laufzeit: Die App ist natives Swift, und die Transkription übernimmt OpenAI.

So funktioniert das Diktat

1. Fokussiere ein Textfeld in einer beliebigen Anwendung, etwa Notizen, TextEdit, einem Browser, einer Chat-App oder einem Editor. 2. Halte ⌥ Option + Leertaste gedrückt und sprich. 3. Lass die Tasten los. Haki sendet die Aufnahme an OpenAI, erhält den Text und fügt ihn an deinem Cursor ein.

Haki sichert deine Zwischenablage vor dem Einfügen und stellt sie danach wieder her, und das, ohne der App, in die du tippst, den Fokus zu nehmen. Eine kleine schwebende Anzeige zeigt, ob gerade aufgenommen, transkribiert oder fertig ist. Versehentliche Antipper, die kürzer als etwa eine Drittelsekunde sind, werden lokal verworfen.

Sprachen und Modelle

• Sprachen: Arabisch (mit Optimierung für levantinisches und syrisches Sprechen), Englisch, Deutsch, Französisch oder automatische Erkennung.
• Modelle: gpt-transcribe ist der Standard und auf schnelles, latenzarmes Alltagsdiktat ausgelegt. gpt-4o-transcribe ist die genauere Option für komplexe Sätze, Dialekte und Fachbegriffe. Du wechselst in den Einstellungen oder in der Menüleiste.
• Mikrofone: Wähle das eingebaute Mikrofon, ein USB-Interface oder AirPods. Haki kümmert sich über CoreAudio um das Wiederverbinden und kann AirPods bevorzugen, sobald sie verbunden sind. Eine Pegelanzeige in Echtzeit lässt dich den Eingang testen.

Datenschutz: was auf deinem Mac bleibt und was an OpenAI geht

Sei dir des Kompromisses bewusst: Deine Sprachaufnahmen werden an OpenAI gesendet. Laut README gehen sie direkt von deinem Mac über TLS an den Transkriptions-Endpunkt von OpenAI, ohne Zwischenserver. Das Diktat braucht daher eine Internetverbindung und deinen eigenen OpenAI-API-Schlüssel, genutzt nach den Bedingungen und Preisen von OpenAI.

Auf deinem Mac enthält Haki laut README keine Analytik, Diagnose, Absturzberichte oder SDKs von Dritten. Audio wird in temporäre Dateien aufgenommen und gelöscht, sobald die Transkription fertig ist oder fehlschlägt, es bleibt also kein Audioverlauf. Dein API-Schlüssel liegt im macOS-Schlüsselbund und nicht in Einstellungen, Konfigurationsdateien oder Protokollen.

Berechtigungen

• Mikrofon: um deine Stimme aufzunehmen, und nur, solange du die Taste hältst oder das Diktat über das Menü startest.
• Bedienungshilfen: für die globale Push-to-Talk-Taste und zum Einfügen von Text durch simuliertes ⌘V. Laut README ist „Eingabeüberwachung“ nicht zusätzlich nötig.

Einrichten

1. Öffne Haki. Erlaube den Mikrofonzugriff, wenn macOS fragt, und aktiviere Haki unter Systemeinstellungen, „Datenschutz & Sicherheit“, „Bedienungshilfen“. 2. Öffne die Einstellungen über das Menüleisten-Symbol oder mit ⌘,. Füge im Tab „Transcription“ deinen OpenAI-API-Schlüssel ein, wähle „Save“ und dann „Test API Key“. 3. Wähle ein Modell, und wähle im Tab „Audio“ dein Mikrofon.

Vom iPhone diktieren mit AirMouse

AirMouse ist eine eigenständige Open-Source-App, die ein iPhone über dein lokales WLAN zum Trackpad für deinen Mac macht. Ihr Sprach-Tab nimmt auf dem Telefon auf und übergibt das Audio an Haki, das den Text auf deinem Mac eintippt. Haki muss installiert sein und laufen, und es nutzt deinen üblichen API-Schlüssel sowie deine Modell- und Spracheinstellungen.

Die Übergabe ist einfach und auch für andere Absender offen. Eine Aufnahme (m4a, mp4, webm, wav, mp3 oder ogg, bis 25 MB) wird nach ~/Library/Caches/Haki/Inbox/ geschrieben, dann wird die URL haki://transcribe?file=<Dateiname> geöffnet. Haki transkribiert die Datei, fügt den Text ein und löscht die Datei. Es werden nur einfache Dateinamen im Posteingang akzeptiert, Pfade, versteckte Dateien und Symlinks werden also abgelehnt.

Selbst bauen

Haki braucht macOS 13 Ventura oder neuer, auf Apple Silicon oder Intel, sowie die Xcode Command Line Tools mit Swift 6.0 oder neuer. Klone das Repository von GitHub, führe swift test und dann ./scripts/build_app.sh aus. Das Skript baut die Release-Binärdatei, stellt Haki.app zusammen, signiert sie mit deinem lokalen Apple-Development-Zertifikat oder einer Ad-hoc-Signatur und installiert sie in /Applications.

Open Source

Haki steht unter der MIT-Lizenz. Der Leitfaden zum Mitwirken verlangt keine lokalen Modelle, kein Python, kein Node.js und kein Electron und dass API-Schlüssel nie committet werden. Emad Alhamou, der Autor dieser Website, veröffentlicht Haki auf GitHub. Fehlerberichte und Pull Requests sind willkommen, und Sicherheitsbedenken laufen über die Sicherheitsrichtlinie des Repositorys.