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
Große Dateien
Wenn du einen lokalen Dateipfad übergibst, reicht die CLI den Pfad an die laufende TypeWhisper-App weiter, statt die Dateibytes hochzuladen. Dadurch gilt das HTTP-Upload-Limit nicht für große Aufnahmen.
Per Pipe übergebenes stdin nutzt weiterhin den Upload-Endpunkt /v1/transcribe und ist auf 256 MiB begrenzt. Größere stdin-Uploads liefern 413 Payload Too Large.
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