CLI Tool

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

models load#

Verfügbar ab TypeWhisper 1.8.

Ein Modell bei Bedarf herunterladen, laden und für die Transkription auswählen. Die Engine- und Modell-IDs liefert typewhisper models. Der Befehl wartet, bis das Modell bereit ist, bei einem Download bis zu zehn Minuten, und gibt dann den Status aus. Mit --json erhältst du die API-Antwort.

typewhisper models load --engine parakeet --model parakeet-tdt-0.6b-v3

ready: parakeet parakeet-tdt-0.6b-v3

models unload#

Verfügbar ab TypeWhisper 1.8.

Das aktive Modell einer Engine entladen, um Arbeitsspeicher freizugeben. Die heruntergeladenen Dateien bleiben auf deinem Mac. Der Befehl erwartet nur --engine; mit --model bricht er mit einem Fehler ab.

typewhisper models unload --engine parakeet

unloaded: parakeet parakeet-tdt-0.6b-v3

models delete#

Verfügbar ab TypeWhisper 1.8.

Die heruntergeladenen Dateien eines Modells löschen. Das funktioniert nur bei Engines, die ihre Modelldownloads selbst verwalten, etwa WhisperKit. Bei anderen Engines wie Parakeet meldet TypeWhisper einen Fehler.

typewhisper models delete --engine whisper --model openai_whisper-large-v3_turbo

deleted: whisper openai_whisper-large-v3_turbo

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

transcribe#

Eine Audiodatei oder per Pipe eingegebenes Audio transkribieren.

typewhisper transcribe recording.wav

export#

Alle unterstützten Einstellungen in eine JSON-Datei im TypeWhisper-Backupformat exportieren.

typewhisper export typewhisper-settings.json

import#

Alle Kategorien eines TypeWhisper-Einstellungs-Backups importieren und eine Zusammenfassung übernommener und übersprungener Daten ausgeben.

typewhisper import typewhisper-settings.json

import --replace#

Verfügbar ab TypeWhisper 1.8.

Ein Backup wie mit import importieren und zusätzlich Workflows, Profile und Prompt-Aktionen mit gleichem Namen sowie die Hotkey-Slots aus dem Backup überschreiben. So übernimmst du Änderungen, die du in einer exportierten Datei gemacht hast. Gelöscht wird nichts; Profile behalten ihre Priorität und Workflows ihre Position. Mit --json erhältst du die API-Antwort.

typewhisper import typewhisper-settings.json --replace

Workflows: 0 imported, 1 updated, 7 skipped
Dictionary: 0 imported, 52 skipped
Snippets: 0 imported, 6 skipped
Prompt Actions: 0 imported, 0 updated, 2 skipped
Profiles: 0 imported, 0 updated, 2 skipped
Hotkeys: 1 applied, 7 skipped
Plugins: 0 installed, 2 skipped
History: 0 imported, 41 skipped as duplicates, 0 skipped by retention
Preferences: 27 applied
Update channel applied

HTTP-API: Einstellungs-Backup: API und CLI

audio#

Verfügbar ab TypeWhisper 1.8.

Den Eingang der nächsten Aufnahme, die Mikrofon-Priorität, die angeschlossenen Eingabegeräte mit ihren Geräte-IDs sowie die Einstellungen für Audio Ducking, Medienpause und Sound-Feedback anzeigen. Mit --json erhältst du die API-Antwort, etwa zum Speichern.

typewhisper audio

Active input: MacBook Pro Microphone [BuiltInMicrophoneDevice]
Input priority:
  1. HyperX QuadCast 2 [AppleUSBAudioEngine:HyperX:QuadCast 2] (not connected)
Available inputs:
  MacBook Pro Microphone [BuiltInMicrophoneDevice] (system default)
  BlackHole 2ch [BlackHole2ch_UID]
Audio ducking: on (20% volume)
Pause media during recording: off
Sound feedback: on

audio set#

Verfügbar ab TypeWhisper 1.8.

Audioeinstellungen mit einem JSON-Objekt aus einer Datei oder mit - von stdin ändern. Wie in der API enthält das Objekt nur die Felder, die du ändern willst. Danach gibt der Befehl die neuen Einstellungen aus. Solange ein Diktat oder eine Recorder-Aufnahme läuft oder noch verarbeitet wird, lehnt TypeWhisper die Änderung ab.

echo '{"input_priority":[{"id":"BlackHole2ch_UID"}]}' | typewhisper audio set -

HTTP-API: Audioeinstellungen

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

Ein portables Backup in ein Dotfiles-Verzeichnis exportieren:

mkdir -p ~/.config/typewhisper
typewhisper export ~/.config/typewhisper/settings.json

Ein Backup wiederherstellen und eine maschinenlesbare Zusammenfassung erhalten:

typewhisper import settings.json --json

Verfügbar ab TypeWhisper 1.8. Änderungen übernehmen, die du in dieser Datei gemacht hast, auch geänderte Hotkeys:

typewhisper import ~/.config/typewhisper/settings.json --replace

Verfügbar ab TypeWhisper 1.8. 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:

typewhisper models
typewhisper models load --engine whisper \
  --model openai_whisper-large-v3_turbo
typewhisper transcribe interview.m4a > interview.txt
typewhisper models unload --engine whisper

Verfügbar ab TypeWhisper 1.8. Eine Zeit lang von BlackHole 2ch aufnehmen und danach deine Audioeinstellungen wiederherstellen:

if typewhisper audio --json > audio-settings.json.tmp &&
  mv audio-settings.json.tmp audio-settings.json; then
  echo '{"input_priority":[{"id":"BlackHole2ch_UID"}],"audio_ducking_enabled":false}' |
    typewhisper audio set -
  printf '%s ' "Spiele Sprache in BlackHole 2ch ab, diktiere sie und drücke dann die Eingabetaste, um deine Einstellungen wiederherzustellen."
  read -r _
  jq 'del(.input_devices, .active_input)' audio-settings.json |
    typewhisper audio set -
fi