Stabil

Windows ist ein stabiles Desktop-Release. Das optionale Windows-CLI nutzt die lokale HTTP API.

CLI-Tool

Nutze TypeWhisper aus PowerShell, Skripten und lokalen Automatisierungen.

Installieren und vorbereiten

Öffne Einstellungen > Erweitert > Command Line Tool und klicke auf Installieren.
Öffne danach ein neues Terminal, damit der aktualisierte Benutzer-PATH geladen wird.
Aktiviere unter Einstellungen > Erweitert > API Server den lokalen Server.
Prüfe die Verbindung mit typewhisper status.

typewhisper status

Die CLI ist ein Client der lokalen HTTP API. TypeWhisper muss laufen und der API-Server muss aktiviert sein.

Automatische Discovery und Token

Ohne --port liest die CLI zuerst %LOCALAPPDATA%\TypeWhisper\api-discovery.json, danach die ältere Datei api-port und verwendet zuletzt 8978 als Fallback.

Hinweis zum aktuellen Stable-Client: Die App schreibt ihre Discovery-Dateien bereits nach %LOCALAPPDATA%\TypeWhisper-UserData, die CLI prüft jedoch noch den früheren Ordner oben. Port 8978 funktioniert über den Fallback. Verwende bei einem abweichenden Port --port.

Ein Token wird übernommen, wenn die CLI ihre Discovery-Datei findet. Setze beim aktuellen Stable-Client für Token-Schutz zuverlässig TYPEWHISPER_API_TOKEN oder --api-token. Die Priorität lautet: --api-token, Umgebungsvariable, Discovery.

Befehle

status

Zeigt API-, Engine- und Modellstatus.

typewhisper status

models

Listet die aktuell verfügbaren lokalen und Cloud-Modelle.

typewhisper models

transcribe <file|->

Transkribiert einen lokalen Dateipfad oder Raw-Audio von stdin.

typewhisper transcribe meeting.m4a
typewhisper transcribe - < audio.wav

Globale Flags

Flag	Beschreibung
--port <N>	Port überschreiben; sonst CLI-Discovery, danach Fallback 8978
--api-token <token>	Token aus Discovery und Umgebungsvariable überschreiben
--json	Maschinenlesbare JSON-Ausgabe
--version	CLI-Version ausgeben
--help, -h	Hilfe anzeigen

Flags für transcribe

Flag	Beschreibung
--language <code>	Eine feste Quellsprache setzen
--language-hint <code>	Wiederholbarer, geordneter Hinweis für Auto-Erkennung
--task <task>	transcribe oder translate
--translate-to <code>	Zielsprache für Übersetzung
--engine <id>	Engine nur für diese Anfrage überschreiben
--model <id>	Modell nur für diese Anfrage überschreiben
--await-download	Auf Wiederherstellung oder Download eines lokalen Modells warten

--language und --language-hint dürfen nicht gemeinsam verwendet werden. Wiederhole --language-hint für mehrere Hinweise in gewünschter Reihenfolge.

Beispiele

typewhisper transcribe recording.wav --language de --json
typewhisper transcribe recording.wav --language-hint de --language-hint en
typewhisper transcribe recording.wav --engine <engine-id> --model <model-id>
typewhisper transcribe recording.wav --task translate --translate-to en
typewhisper transcribe recording.wav --await-download
typewhisper --port 9000 status

HTTP API und Authentifizierung