VoiceInk Custom Commands: pošlete diktování do skriptu místo vložení

Text: · Zveřejněno

Custom Command (vlastní příkaz) je jeden z výstupních režimů VoiceInku. Místo vložení předá VoiceInk hotový text diktování příkazu shellu, který napíšete vy, a ten rozhodne, co se stane: připojí text k poznámce, otevře vyhledávání, zavolá váš skript nebo ho odešle službě, kterou provozujete. Je to nejflexibilnější věc, kterou VoiceInk s textem umí, a má několik pevných limitů, které je dobré znát, než na tom začnete stavět.

Vyvíjím YapToText, jinou aplikaci pro diktování na Macu, takže na to při čtení o VoiceInku myslete. Každý údaj o VoiceInku je z jeho vlastní dokumentace, přečtené 10. října 2026.

Stáhnout YapToText v Mac App StoruKe stažení zdarma. Bez účtu a bez zamčených funkcí, pro macOS 14 nebo novější na Macu s čipem Apple. Zdrojový kód na GitHubu.

Tento návod v dalších jazycích: English, العربية, Dansk, Deutsch, Ελληνικά, 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, 简体中文, 繁體中文

Co příkaz dostane

VoiceInk pošle stejný konečný text dvěma způsoby: na standardní vstup a v proměnné $VOICEINK_TRANSCRIPT. Text je v UTF-8 a dokumentace žádá, abyste proměnnou uvedli v uvozovkách, aby mezery, interpunkce a zalomení řádků přežily.

  • AI Enhancement (úprava pomocí AI) vypnuté. Přepis po formátování VoiceInku a nahrazení slov.
  • AI Enhancement zapnuté a funguje. Upravený text.
  • AI Enhancement přeskočené nebo selhalo. Běžný konečný přepis.

Příkaz nikdy nedostane přímo zvuk, prompt ani vybraný text, text ze schránky nebo z obrazovky. Pokud chcete, aby výsledek ovlivnil kontext, dokumentace radí použít prompt a Context Awareness (využití kontextu), aby byl kontext už v konečném textu.

Jak běží

Z dokumentace VoiceInku, stránka Custom Commands, přečtené 10. října 2026.

PodrobnostChování
Shell/bin/zsh -lc
Časový limit10 sekund, potom VoiceInk příkaz zastaví
OprávněníStejná oprávnění uživatele macOS jako VoiceInk
Nahrávací oknoZavře se před spuštěním příkazu
ÚspěchNávratový kód 0. Cokoli jiného se počítá jako selhání
VýstupStandardní výstup a chyby se uchovávají pro diagnostiku, nikdy se nevkládají do aplikace
Nenalezené příkazyVoiceInk zkusí cestu PATH vašeho shellu. Pokud selže, použijte úplnou cestu, například /opt/homebrew/bin/tool

Limity, na které lidé narážejí

  • Nic se nevkládá za vás. Pokud chcete text i v aplikaci, musí ho váš příkaz zkopírovat nebo vložit sám.
  • Deset sekund a žádné otázky. Příkaz nemůže čekat na vstup. Pro delší práci spusťte vlastní proces na pozadí a rychle skončete.
  • Neupravuje uložený přepis. Cokoli příkaz vypíše, se zpět nezapisuje.
  • Bez Auto Send. Funkce Auto Send (automatické odeslání) funguje jen s výstupem Paste (vložení), ne s Custom Command.
  • Jen živé diktování. Soubory ve frontě Transcribe file (přepis souboru) se uloží bez spuštění výstupních příkazů.
  • Žádný prázdný příkaz. Režim Mode s prázdným příkazem nejde uložit.

Vestavěné šablony

Z dokumentace VoiceInku, stránka Custom Commands, přečtené 10. října 2026.

ŠablonaCo dělá
Paste and Press TabZkopíruje text, vloží ho a potom stiskne Tab
Lowercase and PastePřevede text na malá písmena, zkopíruje ho a vloží
Remove Trailing Period and PastePřed vložením odstraní jednu závěrečnou tečku
Append to JournalPřidá text do ~/Documents/VoiceInk/journal.md
Search WebOtevře webové vyhledávání textu

Dokumentace radí začít ze šablony a upravit ji. Dva z jejích nejjednodušších příkladů, zkopírování textu a jeho připojení k poznámce:

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

Jak zjistit, zda to fungovalo

VoiceInk po příkazu Custom Command nezobrazí zprávu o úspěchu ani selhání. Dokumentace uvádí příkaz pro Terminál, který ukáže protokoly doručení za posledních 10 minut, včetně toho, zda příkaz uspěl, selhal nebo běžel déle než 10 sekund:

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

Dokumentace upozorňuje, že tyto protokoly mohou obsahovat nadiktovaný text. A pokud váš příkaz posílá text webové službě, tato služba ho dostane: VoiceInk jen spouští to, co jste nastavili.

Kde stojí YapToText

VoiceInk podle jeho dokumentace, přečtené 10. října 2026. YapToText podle jeho vlastního nastavení.

VoiceInkYapToText
Spustit příkaz shellu s textemAno, výstup Custom CommandNe
Vložit na kurzorVýstup PasteVložení, výchozí
Napsat místo vloženíNa této stránce není popsánoPsaní znak po znaku
Jen schránkaS příkazem, například pbcopyJen zkopírovat do schránky
Stisknout klávesu potomŠablona Paste and Press TabReturn nebo Command Return podle aplikace
Zkontrolovat, než text dorazíNa této stránce není popsánoKontrola před vložením, ve výchozím stavu vypnutá

Pokud chcete, aby diktování ovládalo vaše vlastní skripty, Custom Command ve VoiceInku dělá něco, co YapToText neumí. Pokud chcete text na kurzoru, upravený podle okolních slov, YapToText to dělá ve výchozím stavu a žádný skript nepotřebuje. Stránka o režimech VoiceInku popisuje, kde se výstupní režimy nastavují, a VoiceInk proti superwhisper ho srovnává s další aplikací postavenou na režimech.

Stáhnout YapToText v Mac App StoruKe stažení zdarma. Bez účtu a bez zamčených funkcí, pro macOS 14 nebo novější na Macu s čipem Apple. Zdrojový kód na GitHubu.

Stručně

  • Co to je. Výstupní režim, který spustí váš příkaz shellu s konečným textem.
  • Text. Na standardním vstupu a v $VOICEINK_TRANSCRIPT.
  • Limity. 10 sekund, žádný vstup, žádné automatické vložení, jen živé diktování.
  • Ladění. V aplikaci žádná zpráva. Přečtěte si protokol příkazem pro Terminál výše.
  • Začněte tady. Upravte jednu z pěti šablon.

Pokud VoiceInk změní fungování Custom Commands, založte issue na GitHubu a stránku aktualizuji. Čtu všechna.

Stáhnout YapToText v Mac App StoruKe stažení zdarma. Bez účtu a bez zamčených funkcí, pro macOS 14 nebo novější na Macu s čipem Apple. Zdrojový kód na GitHubu.

Kdo píše. Ryleigh Newman vyvíjí software, psaní na klávesnici zvládá jen s obtížemi a každý den diktuje v YapToText, aplikaci, o které je tento web. Tato stránka je přeložená z angličtiny. Rozhraní aplikace a zbytek webu jsou v angličtině. Více o projektu, anglicky.

Další návody, anglicky

Zdroje

Otázky

Co je Custom Command ve VoiceInku?

Výstupní režim. Místo vložení VoiceInk spustí příkaz shellu, který napíšete, a předá mu konečný text diktování.

Jak dostane příkaz Custom Command ve VoiceInku text?

Na standardním vstupu a v proměnné $VOICEINK_TRANSCRIPT, v UTF-8. Proměnnou uvádějte v uvozovkách, aby zůstaly mezery a zalomení řádků.

Proč můj Custom Command ve VoiceInku nic nevložil?

Výstup Custom Command nevkládá sám od sebe. Váš příkaz musí text zkopírovat nebo vložit sám, jako to dělá šablona Paste and Press Tab.

Jak dlouho smí Custom Command ve VoiceInku běžet?

10 sekund. Potom ho VoiceInk zastaví. Pro delší práci spusťte proces na pozadí.

Má YapToText vlastní příkazy jako VoiceInk?

Po diktování nespouští příkazy shellu. Vkládá nebo píše na kurzor, umí text jen zkopírovat do schránky a po vložení textu umí stisknout Return.