CLI Tool

Ein shell-freundliches Kommandozeilen-Tool, das sich mit dem TypeWhisper API-Server für Transkription vom Terminal aus verbindet.

Installation

Installiere die CLI über die TypeWhisper-App: Einstellungen > Erweitert > CLI Tool > Installieren. Dies platziert die typewhisper Binary unter /usr/local/bin/typewhisper.

Die TypeWhisper-App muss mit aktiviertem API-Server laufen, damit die CLI funktioniert.

Befehle

status

Prüfen, ob der API-Server läuft und welches Modell geladen ist.

typewhisper status

models

Alle verfügbaren Modelle und ihren Status auflisten.

typewhisper models

transcribe

Eine Audiodatei oder per Pipe eingegebenes Audio transkribieren.

typewhisper transcribe recording.wav

Optionen

Flag	Beschreibung
`--port`	API-Server-Port (Standard: 8978)
`--json`	Vollständige JSON-Antwort ausgeben
`--language`	ISO 639-1-Sprachcode (z.B. en, de)
`--task`	transcribe (Standard) oder translate
`--translate-to`	Zielsprache für Übersetzung (z.B. de, fr)

Beispiele

Datei transkribieren:

typewhisper transcribe meeting.m4a

Audio von stdin einlesen:

ffmpeg -i video.mp4 -f wav - | typewhisper transcribe -

JSON-Ausgabe mit jq:

typewhisper transcribe --json recording.wav | jq .text

Ins Deutsche übersetzen:

typewhisper transcribe --translate-to de recording.wav

Benutzerdefinierten Port verwenden:

typewhisper --port 9000 status