Windows

CLI-Tool

Nutze TypeWhisper aus PowerShell, Skripten und lokalen Automatisierungen.

Auf dieser Seite

Installieren und vorbereiten

Öffne Einstellungen > Erweitert > Kommandozeilen-Tool und klicke auf Installieren.
Öffne danach ein neues Terminal, damit der aktualisierte Benutzer-PATH geladen wird.
Schalte unter Einstellungen > Erweitert > API-Server „HTTP-API aktivieren“ ein.
Prüfe die Verbindung mit typewhisper status.

powershell

typewhisper status

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

Automatische Discovery und Token

Ohne --port liest die CLI die Datei api-discovery.json im Profil der App, die sie installiert hat, danach die ältere Datei api-port, und verwendet zuletzt 8978 als Fallback. Eine CLI ohne diese Bindung prüft %LOCALAPPDATA%\TypeWhisper-WinUI.

Für ein anderes Profil, etwa das der Microsoft-Store-Version, gibst du dessen Ordner mit --profile <directory> an oder setzt die Umgebungsvariable TYPEWHISPER_PROFILE darauf. Die CLI liest dann nur die Discovery-Dateien dieses Ordners.

powershell

typewhisper status --profile "$env:LOCALAPPDATA\Packages\TypeWhisper.TypeWhisper_51tqb5623pxja\LocalCache\Local\TypeWhisper-WinUI"

Das Token aus der Discovery-Datei verwendet die CLI nur für den dort angegebenen Port; meldet die Discovery, dass kein Token verlangt wird, verwendet die CLI es nicht. Die Priorität lautet: --api-token, Umgebungsvariable TYPEWHISPER_API_TOKEN, Discovery.

Befehle

`status`

Zeigt API-, Engine- und Modellstatus.

powershell

typewhisper status

`models`

Listet die aktuell verfügbaren lokalen und Cloud-Modelle. Die Spalten ID und ENGINE enthalten die IDs für die folgenden Befehle; ein Sternchen markiert das ausgewählte Modell.

powershell

typewhisper models

`models load`

Ein Modell laden und für die Transkription auswählen. Die Engine- und Modell-IDs liefert typewhisper models. Der Befehl lädt nichts herunter; ein lokales Modell muss also bereits heruntergeladen sein. Er wartet, bis das Modell geladen ist, und gibt dann den Status aus. Mit --json erhältst du die API-Antwort.

powershell

typewhisper models load --engine sherpa-onnx --model parakeet-tdt-0.6b

Ausgabe

ready: sherpa-onnx parakeet-tdt-0.6b

`models unload`

Das Modell einer Engine entladen, um Arbeitsspeicher freizugeben. Die heruntergeladenen Dateien bleiben auf deinem PC. Der Befehl braucht nur --engine; --model nimmt er an, ignoriert es aber. Nach dem Entladen von Parakeet hat TypeWhisper kein Modell bereit, bis du wieder eines lädst.

powershell

typewhisper models unload --engine sherpa-onnx

Ausgabe

unloaded: sherpa-onnx parakeet-tdt-0.6b

`models delete`

Die heruntergeladenen Dateien eines Modells löschen. Das funktioniert bei lokalen Engines, deren Plugin Modelldateien entfernen kann, etwa Parakeet und whisper.cpp; bei Cloud-Engines meldet TypeWhisper einen Fehler. Das Modell, das eine Engine ausgewählt hat oder noch geladen haben könnte, löscht TypeWhisper nicht.

powershell

typewhisper models delete --engine sherpa-onnx --model canary-180m-flash

Ausgabe

deleted: sherpa-onnx canary-180m-flash

HTTP-API: Modelle laden, entladen und löschen

`transcribe <file|->`

Transkribiert einen lokalen Dateipfad oder Raw-Audio von stdin.

shell

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

Globale Flags

Flag	Beschreibung
`--port <N>`	Port überschreiben; sonst CLI-Discovery, danach Fallback 8978
`--profile <directory>`	Discovery-Dateien aus diesem Profilordner lesen; ersetzt die Umgebungsvariable TYPEWHISPER_PROFILE
`--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.

Flags für Modellbefehle

Flag	Beschreibung
`--engine <id>`	Engine, auf die sich der Befehl bezieht; immer erforderlich
`--model <id>`	Modell, auf das sich der Befehl bezieht; erforderlich für load und delete, von unload ignoriert

Diese Flags gelten für models load, models unload und models delete. Die gleichnamigen Flags von transcribe überschreiben das Modell nur für eine Anfrage.

Beispiele

powershell

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

Für einen Auftrag zu einem anderen Modell wechseln und es danach entladen, um Arbeitsspeicher freizugeben. models load macht das Modell auch zum ausgewählten Modell in TypeWhisper. Lade danach dein übliches Modell, um zurückzuwechseln:

powershell

typewhisper models
typewhisper models load --engine whisper-cpp --model large-v3-turbo
typewhisper transcribe interview.m4a
typewhisper models unload --engine whisper-cpp

HTTP API und Authentifizierung