VoiceInk Custom Commands: schicke dein Diktat an ein Skript, statt es einzufügen
Von Ryleigh Newman · Veröffentlicht am
Custom Command ist einer der Ausgabemodi von VoiceInk. Statt den Text einzufügen, übergibt VoiceInk den fertigen Text eines Diktats an einen Shell-Befehl, den du schreibst, und dieser Befehl entscheidet, was passiert: ihn an eine Notiz anhängen, eine Suche öffnen, dein eigenes Skript aufrufen oder ihn an einen Dienst schicken, den du betreibst. Es ist das Flexibelste, was VoiceInk mit Text macht, und es hat einige feste Grenzen, die du kennen solltest, bevor du darauf aufbaust.
Ich habe YapToText entwickelt, eine andere Diktier-App für den Mac, also lies meine Aussagen über VoiceInk mit diesem Wissen. Jede Angabe zu VoiceInk stammt hier aus seiner eigenen Dokumentation, gelesen am 10. Oktober 2026.
Kostenlos laden. Kein Konto, nichts gesperrt, für macOS 14 oder neuer auf einem Mac mit Apple Chip. Quellcode auf GitHub.
Diese Anleitung in anderen Sprachen: English, العربية, Čeština, Dansk, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Auf dieser Seite: 11 Abschnitte
Was der Befehl erhält
VoiceInk sendet denselben fertigen Text auf zwei Wegen: über die Standardeingabe und in der Variablen $VOICEINK_TRANSCRIPT. Der Text ist UTF-8, und die Dokumentation bittet dich, die Variable in Anführungszeichen zu setzen, damit Leerzeichen, Satzzeichen und Zeilenumbrüche erhalten bleiben.
- AI Enhancement aus. Das Transkript nach VoiceInks Formatierung und Wortersetzungen.
- AI Enhancement an und erfolgreich. Der verbesserte Text.
- AI Enhancement übersprungen oder fehlgeschlagen. Das einfache fertige Transkript.
Der Befehl erhält nie das Audio, den Prompt oder den ausgewählten Text, den Text der Zwischenablage oder des Bildschirms direkt. Soll Kontext das Ergebnis prägen, sagt die Dokumentation, nutze einen Prompt und Context Awareness (Kontextbewusstsein), damit er schon im fertigen Text steckt.
Wie er läuft
Aus VoiceInks Dokumentation, Custom Commands, gelesen am 10. Oktober 2026.
| Detail | Verhalten |
|---|---|
| Shell | /bin/zsh -lc |
| Zeitlimit | 10 Sekunden, dann beendet VoiceInk den Befehl |
| Berechtigungen | Dieselben macOS-Benutzerrechte wie VoiceInk |
| Recorder | Wird geschlossen, bevor der Befehl startet |
| Erfolg | Exit-Code 0. Alles andere zählt als Fehler |
| Ausgabe | Standardausgabe und Fehler werden für die Diagnose aufbewahrt und nie in die App eingefügt |
| Befehle nicht gefunden | VoiceInk versucht den PATH deiner Shell. Nimm einen vollständigen Pfad wie /opt/homebrew/bin/tool, wenn das scheitert |
Die Grenzen, an denen man hängen bleibt
- Es wird nichts für dich eingefügt. Willst du den Text trotzdem in der App haben, muss dein Befehl ihn selbst kopieren oder einfügen.
- Zehn Sekunden, keine Rückfragen. Der Befehl kann nicht auf Eingaben warten. Für längere Arbeit startest du einen eigenen Hintergrundprozess und beendest den Befehl schnell.
- Er ändert das gespeicherte Transkript nicht. Was der Befehl ausgibt, wird nicht zurückgeschrieben.
- Kein Auto Send. Auto Send funktioniert nur mit der Ausgabe Paste, nicht mit Custom Command.
- Nur Live-Diktat. Dateien in der Warteschlange von Transcribe file werden gespeichert, ohne dass Ausgabebefehle laufen.
- Kein leerer Befehl. Ein Modus mit leerem Befehl lässt sich nicht speichern.
Die eingebauten Vorlagen
Aus VoiceInks Dokumentation, Custom Commands, gelesen am 10. Oktober 2026.
| Vorlage | Was sie tut |
|---|---|
| Paste and Press Tab | Kopiert den Text, fügt ihn ein und drückt dann die Tabulatortaste |
| Lowercase and Paste | Setzt den Text in Kleinbuchstaben, kopiert ihn und fügt ihn ein |
| Remove Trailing Period and Paste | Entfernt einen letzten Punkt vor dem Einfügen |
| Append to Journal | Hängt den Text an ~/Documents/VoiceInk/journal.md an |
| Search Web | Öffnet eine Websuche für den Text |
Die Dokumentation empfiehlt, mit einer Vorlage zu beginnen und sie zu bearbeiten. Zwei ihrer einfachsten Beispiele, den Text kopieren und an eine Notiz anhängen:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Prüfen, ob es funktioniert hat
VoiceInk zeigt nach einem Custom Command keine Erfolgs- oder Fehlermeldung. Die Dokumentation nennt einen Terminal-Befehl, der die Zustellprotokolle der letzten 10 Minuten zeigt, auch ob der Befehl erfolgreich war, fehlschlug oder länger als 10 Sekunden lief:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'Die Dokumentation warnt, dass diese Protokolle diktierten Text enthalten können. Und schickt dein Befehl Text an einen Webdienst, erhält dieser Dienst ihn: VoiceInk führt nur aus, was du eingerichtet hast.
Wo YapToText steht
VoiceInk aus seiner Dokumentation, gelesen am 10. Oktober 2026. YapToText aus seinen eigenen Einstellungen.
| VoiceInk | YapToText | |
|---|---|---|
| Einen Shell-Befehl mit dem Text ausführen | Ja, Ausgabe Custom Command | Nein |
| An der Einfügemarke einfügen | Paste | Paste, die Standardeinstellung |
| Stattdessen tippen | Auf dieser Seite nicht beschrieben | Type character by character |
| Nur Zwischenablage | Mit einem Befehl wie pbcopy | Copy to clipboard only |
| Danach eine Taste drücken | Vorlage Paste and Press Tab | Return oder Command Return pro App |
| Vor dem Einfügen prüfen | Auf dieser Seite nicht beschrieben | Review before inserting, standardmäßig aus |
Wenn dein Diktat deine eigenen Skripte steuern soll, kann der Custom Command von VoiceInk etwas, das YapToText nicht kann. Wenn du Text an der Einfügemarke willst, angepasst an die Wörter drumherum, macht YapToText das standardmäßig und braucht kein Skript. Die Seite zu den VoiceInk-Modi zeigt, wo Ausgabemodi eingestellt werden, und VoiceInk im Vergleich mit superwhisper stellt es einer anderen App gegenüber, die auf Modi aufbaut.
Kostenlos laden. Kein Konto, nichts gesperrt, für macOS 14 oder neuer auf einem Mac mit Apple Chip. Quellcode auf GitHub.
Kurz gesagt
- Was es ist. Ein Ausgabemodus, der deinen Shell-Befehl mit dem fertigen Text ausführt.
- Der Text. Auf der Standardeingabe und in $VOICEINK_TRANSCRIPT.
- Grenzen. 10 Sekunden, keine Eingabe, kein automatisches Einfügen, nur Live-Diktat.
- Fehlersuche. Keine Meldung in der App. Lies das Protokoll mit dem Terminal-Befehl oben.
- Fang hier an. Bearbeite eine der fünf Vorlagen.
Wenn VoiceInk ändert, wie Custom Commands funktionieren, eröffne ein Issue auf GitHub, und ich aktualisiere diese Seite. Ich lese jedes.
Kostenlos laden. Kein Konto, nichts gesperrt, für macOS 14 oder neuer auf einem Mac mit Apple Chip. Quellcode auf GitHub.
Anleitungen
Weitere Anleitungen, auf Englisch
Quellen
- https://tryvoiceink.com/docs/custom-commands (geprüft am 10. Oktober 2026)
- https://tryvoiceink.com/docs/mode-settings (geprüft am 10. Oktober 2026)
- https://github.com/ryleighnewman/YapToText (geprüft am 10. Oktober 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (geprüft am 10. Oktober 2026)
Fragen
Was ist ein Custom Command in VoiceInk?
Ein Ausgabemodus. Statt den Text einzufügen, führt VoiceInk einen Shell-Befehl aus, den du schreibst, und übergibt ihm den fertigen Text des Diktats.
Wie erhält ein VoiceInk Custom Command den Text?
Über die Standardeingabe und in der Variablen $VOICEINK_TRANSCRIPT, als UTF-8. Setze die Variable in Anführungszeichen, damit Leerzeichen und Zeilenumbrüche erhalten bleiben.
Warum hat mein VoiceInk Custom Command nichts eingefügt?
Die Ausgabe Custom Command fügt nicht von selbst ein. Dein Befehl muss den Text selbst kopieren oder einfügen, so wie es die Vorlage Paste and Press Tab macht.
Wie lange darf ein VoiceInk Custom Command laufen?
10 Sekunden. Danach beendet VoiceInk ihn. Für längere Arbeit startest du einen Hintergrundprozess.
Hat YapToText Custom Commands wie VoiceInk?
Nach einem Diktat führt es keine Shell-Befehle aus. Es fügt an der Einfügemarke ein oder tippt, kann nur in die Zwischenablage kopieren und kann Return drücken, nachdem der Text gelandet ist.