VoiceInk Custom Commands: pošlite diktovanie skriptu namiesto vloženia textu

Text: · Zverejnené

Custom Command je jeden z výstupných režimov VoiceInk. Namiesto vloženia textu odovzdá VoiceInk hotový text diktovania príkazu shellu, ktorý napíšete vy, a ten rozhodne, čo sa stane: pridá text do poznámky, otvorí vyhľadávanie, zavolá váš skript alebo ho odošle službe, ktorú prevádzkujete. Je to najflexibilnejšia vec, čo VoiceInk s textom robí, a má niekoľko pevných limitov, ktoré je dobré poznať skôr, než na tom niečo postavíte.

Vyvíjam YapToText, inú aplikáciu na diktovanie pre Mac, takže čítajte, čo píšem o VoiceInk, s týmto vedomím. Každý fakt o VoiceInk tu pochádza z jeho vlastnej dokumentácie, prečítanej 10. októbra 2026.

Stiahnuť YapToText v Mac App StoreNa stiahnutie zadarmo. Bez účtu a bez zamknutých funkcií, pre macOS 14 alebo novší na Macu s čipom Apple. Zdrojový kód na GitHube.

Tento návod v ďalších jazykoch: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文

Čo príkaz dostane

VoiceInk posiela ten istý hotový text dvoma spôsobmi: na štandardný vstup a v premennej $VOICEINK_TRANSCRIPT. Text je v UTF-8 a dokumentácia žiada, aby ste premennú uzavreli do úvodzoviek, aby sa zachovali medzery, interpunkcia a zalomenia riadkov.

  • AI Enhancement vypnuté. Prepis po formátovaní VoiceInk a po náhradách slov.
  • AI Enhancement zapnuté a funguje. Vylepšený text.
  • AI Enhancement preskočené alebo zlyhalo. Obyčajný hotový prepis.

Príkaz nikdy nedostane priamo zvuk, prompt ani vybraný text, text zo schránky či z obrazovky. Ak chcete, aby kontext ovplyvnil výsledok, dokumentácia radí použiť prompt a Context Awareness, aby bol už v hotovom texte.

Ako beží

Z dokumentácie VoiceInk, Custom Commands, prečítanej 10. októbra 2026.

DetailSprávanie
Shell/bin/zsh -lc
Časový limit10 sekúnd, potom VoiceInk príkaz zastaví
OprávneniaRovnaké oprávnenia používateľa macOS ako má VoiceInk
NahrávačZatvorí sa pred spustením príkazu
ÚspechNávratový kód 0. Čokoľvek iné sa považuje za zlyhanie
VýstupŠtandardný výstup a chyby sa uchovávajú na diagnostiku, do aplikácie sa nikdy nevložia
Nenájdené príkazyVoiceInk skúsi PATH vášho shellu. Ak to zlyhá, použite úplnú cestu, napríklad /opt/homebrew/bin/tool

Limity, na ktoré ľudia narazia

  • Nič sa za vás nevloží. Ak chcete text stále v aplikácii, váš príkaz ho musí skopírovať alebo vložiť sám.
  • Desať sekúnd a žiadne otázky. Príkaz nemôže čakať na vstup. Pri dlhšej práci spustite vlastný proces na pozadí a rýchlo skončite.
  • Nemení uložený prepis. Čokoľvek príkaz vypíše, sa späť nezapíše.
  • Bez Auto Send. Auto Send funguje len s Paste output, nie s Custom Command.
  • Len živé diktovanie. Súbory vo fronte Transcribe file sa uložia bez spustenia výstupných príkazov.
  • Žiadny prázdny príkaz. Režim (Mode) s prázdnym príkazom sa nedá uložiť.

Vstavané šablóny

Z dokumentácie VoiceInk, Custom Commands, prečítanej 10. októbra 2026.

ŠablónaČo robí
Paste and Press TabSkopíruje text, vloží ho a potom stlačí Tab
Lowercase and PasteZmení text na malé písmená, skopíruje ho a potom vloží
Remove Trailing Period and PastePred vložením odstráni jednu záverečnú bodku
Append to JournalPridá text do ~/Documents/VoiceInk/journal.md
Search WebOtvorí webové vyhľadávanie textu

Dokumentácia radí začať od šablóny a upraviť ju. Dva z jej najjednoduchších príkladov, kopírovanie textu a jeho pridanie do poznámky:

printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopy
mkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"

Ako zistiť, či to zafungovalo

VoiceInk po Custom Command nezobrazí správu o úspechu ani zlyhaní. Dokumentácia uvádza príkaz pre Terminal, ktorý zobrazí záznamy doručenia za posledných 10 minút vrátane toho, či príkaz uspel, zlyhal alebo bežal dlhšie ako 10 sekúnd:

/usr/bin/log show --last 10m --style compact \
  --predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'

Dokumentácia upozorňuje, že tieto záznamy môžu obsahovať nadiktovaný text. A ak váš príkaz posiela text webovej službe, táto služba ho dostane: VoiceInk spúšťa len to, čo ste nastavili.

Ako je na tom YapToText

VoiceInk podľa jeho dokumentácie, prečítanej 10. októbra 2026. YapToText podľa vlastných nastavení.

VoiceInkYapToText
Spustiť príkaz shellu s textomÁno, výstup Custom CommandNie
Vložiť na kurzorPaste outputPaste, predvolená voľba
Napísať ho namiesto vloženiaNa tejto stránke sa neopisujeType character by character
Len do schránkyS príkazom, napríklad pbcopyCopy to clipboard only
Stlačiť kláves potomŠablóna Paste and Press TabReturn alebo Command Return podľa aplikácie
Skontrolovať, kým text dopadneNa tejto stránke sa neopisujeReview before inserting, predvolene vypnuté

Ak chcete, aby diktovanie riadilo vaše vlastné skripty, Custom Command vo VoiceInk robí niečo, čo YapToText nerobí. Ak chcete text na kurzore, prispôsobený slovám okolo, YapToText to robí predvolene a nepotrebuje žiadny skript. Stránka o režimoch VoiceInk opisuje, kde sa výstupné režimy nastavujú, a VoiceInk oproti superwhisper ho porovnáva s ďalšou aplikáciou postavenou na režimoch.

Stiahnuť YapToText v Mac App StoreNa stiahnutie zadarmo. Bez účtu a bez zamknutých funkcií, pre macOS 14 alebo novší na Macu s čipom Apple. Zdrojový kód na GitHube.

Stručne

  • Čo to je. Výstupný režim, ktorý spustí váš príkaz shellu s hotovým textom.
  • Text. Na štandardnom vstupe a v $VOICEINK_TRANSCRIPT.
  • Limity. 10 sekúnd, žiadny vstup, žiadne automatické vloženie, len živé diktovanie.
  • Ladenie. V aplikácii nie je žiadna správa. Prečítajte záznam príkazom pre Terminal vyššie.
  • Začnite tu. Upravte jednu z piatich šablón.

Ak VoiceInk zmení, ako Custom Commands fungujú, založte issue na GitHube a stránku aktualizujem. Čítam každé.

Stiahnuť YapToText v Mac App StoreNa stiahnutie zadarmo. Bez účtu a bez zamknutých funkcií, pre macOS 14 alebo novší na Macu s čipom Apple. Zdrojový kód na GitHube.

Kto píše. Ryleigh Newman vyvíja softvér, písanie na klávesnici zvláda len s ťažkosťami a každý deň diktuje v YapToText, aplikácii, o ktorej je tento web. Táto stránka je preložená z angličtiny. Rozhranie aplikácie a zvyšok webu sú v angličtine. Viac o projekte, po anglicky.

Ďalšie návody, po anglicky

Zdroje

Otázky

Čo je Custom Command vo VoiceInk?

Výstupný režim. Namiesto vloženia textu VoiceInk spustí príkaz shellu, ktorý napíšete, a odovzdá mu hotový text diktovania.

Ako dostane Custom Command vo VoiceInk text?

Na štandardnom vstupe a v premennej $VOICEINK_TRANSCRIPT, v UTF-8. Premennú uzavrite do úvodzoviek, aby sa zachovali medzery a zalomenia riadkov.

Prečo môj Custom Command vo VoiceInk nič nevložil?

Výstup Custom Command sa sám nevkladá. Váš príkaz musí text skopírovať alebo vložiť sám, ako to robí šablóna Paste and Press Tab.

Ako dlho môže Custom Command vo VoiceInk bežať?

10 sekúnd. Potom ho VoiceInk zastaví. Pri dlhšej práci spustite proces na pozadí.

Má YapToText vlastné príkazy ako VoiceInk?

Po diktovaní nespúšťa príkazy shellu. Vloží alebo napíše text na kurzor, vie kopírovať len do schránky a po vložení textu vie stlačiť Return.