VoiceInk Custom Commands: küldd a diktálást szkriptnek a beillesztés helyett
Írta: Ryleigh Newman · Megjelent:
A Custom Command (egyéni parancs) a VoiceInk egyik kimeneti módja. A beillesztés helyett a VoiceInk a diktálás kész szövegét egy általad írt shell parancsnak adja át, és az a parancs dönti el, mi történik: hozzáfűzi egy jegyzethez, megnyit egy keresést, meghív egy saját szkriptet, vagy elküldi egy általad üzemeltetett szolgáltatásnak. Ez a legrugalmasabb dolog, amit a VoiceInk a szöveggel tehet, és van néhány kemény korlátja, amelyet érdemes ismerni, mielőtt építesz rá.
A YapToText nevű másik diktálóalkalmazást fejlesztem Macre, ezért ezt tartsd szem előtt, amikor a VoiceInkről írt részeket olvasod. A VoiceInkről itt írt minden tény a saját dokumentációjából származik, amelyet 2026. október 10-én olvastam el.
Ingyen letölthető. Nincs fiók és nincsenek zárolt funkciók. Apple chippel szerelt Mac és macOS 14 vagy újabb kell hozzá. Forráskód a GitHubon.
Ez az útmutató más nyelveken: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Ezen az oldalon: 11 rész
Mit kap a parancs
A VoiceInk ugyanazt a végső szöveget kétféleképpen küldi: a standard bemeneten és a $VOICEINK_TRANSCRIPT változóban. A szöveg UTF-8 kódolású, és a dokumentáció azt kéri, hogy tedd idézőjelbe a változót, hogy a szóközök, az írásjelek és a sortörések megmaradjanak.
- Kikapcsolt AI Enhancement (MI-alapú javítás). Az átirat a VoiceInk formázása és szócseréi után.
- Bekapcsolt és működő AI Enhancement. A javított szöveg.
- Kihagyott vagy sikertelen AI Enhancement. A sima végső átirat.
A parancs sosem kapja meg közvetlenül a hangot, a promptot, a kijelölt, a vágólapon lévő vagy a képernyőn látható szöveget. Ha azt szeretnéd, hogy a környezet alakítsa az eredményt, a dokumentáció szerint használj promptot és Context Awareness (környezettudatosság) funkciót, így az már a végső szövegben benne van.
Hogyan fut
A VoiceInk dokumentációjából, Custom Commands, 2026. október 10-i olvasat.
| Részlet | Működés |
|---|---|
| Shell | /bin/zsh -lc |
| Időkorlát | 10 másodperc, utána a VoiceInk leállítja a parancsot |
| Jogosultságok | Ugyanazok a macOS-felhasználói jogosultságok, mint a VoiceInké |
| Felvevő | A parancs indulása előtt bezárul |
| Siker | A 0-s kilépési kód. Minden más hibának számít |
| Kimenet | A standard kimenet és a hibák diagnosztikához megmaradnak, de soha nem kerülnek be az alkalmazásba |
| Nem található parancsok | A VoiceInk a shelled PATH változóját próbálja. Ha nem megy, használj teljes elérési utat, például /opt/homebrew/bin/tool |
A korlátok, amelyeken sokan elcsúsznak
- Semmi sem kerül be helyetted. Ha a szöveget mégis az alkalmazásban szeretnéd látni, a parancsodnak kell kimásolnia vagy beillesztenie.
- Tíz másodperc, kérdések nélkül. A parancs nem várhat bemenetre. Hosszabb munkához indíts saját háttérfolyamatot, és lépj ki gyorsan.
- Nem módosítja a mentett átiratot. Amit a parancs kiír, azt a VoiceInk nem írja vissza.
- Nincs Auto Send. Az Auto Send csak a Paste output kimenettel működik, a Custom Command kimenettel nem.
- Csak élő diktálás. A Transcribe file sorban lévő fájlok a kimeneti parancsok futtatása nélkül mentődnek.
- Nincs üres parancs. Az üres parancsú Mode nem menthető.
A beépített sablonok
A VoiceInk dokumentációjából, Custom Commands, 2026. október 10-i olvasat.
| Sablon | Mit csinál |
|---|---|
| Paste and Press Tab | Kimásolja a szöveget, beilleszti, majd megnyomja a Tab billentyűt |
| Lowercase and Paste | Kisbetűssé alakítja a szöveget, kimásolja, majd beilleszti |
| Remove Trailing Period and Paste | Beillesztés előtt elhagyja a záró pontot |
| Append to Journal | Hozzáadja a szöveget a ~/Documents/VoiceInk/journal.md fájlhoz |
| Search Web | Webes keresést nyit a szöveggel |
A dokumentáció azt javasolja, hogy sablonból indulj ki, és szerkeszd át. Két legegyszerűbb példájuk: a szöveg kimásolása, és hozzáfűzése egy jegyzethez:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Annak ellenőrzése, hogy működött-e
A VoiceInk nem jelez sikert vagy hibát a Custom Command után. A dokumentáció ad egy Terminal parancsot, amely az utolsó 10 perc kézbesítési naplóit mutatja, benne azt is, hogy a parancs sikerült, hibázott vagy 10 másodpercnél tovább futott:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'A dokumentáció figyelmeztet, hogy ezek a naplók tartalmazhatnak lediktált szöveget. És ha a parancsod egy webes szolgáltatásnak küld szöveget, azt a szolgáltatás megkapja: a VoiceInk csak azt futtatja, amit beállítottál.
Hol áll a YapToText
A VoiceInk adatai a dokumentációjából valók, 2026. október 10-i olvasat. A YapToText adatai a saját beállításaiból.
| VoiceInk | YapToText | |
|---|---|---|
| Shell parancs futtatása a szöveggel | Igen, a Custom Command kimenet | Nem |
| Beillesztés a kurzornál | Paste output | Paste, az alapértelmezés |
| Begépelés helyette | Ezen az oldalon nincs leírva | Type character by character |
| Csak vágólap | Egy olyan paranccsal, mint a pbcopy | Copy to clipboard only |
| Billentyű megnyomása utána | Paste and Press Tab sablon | Return vagy Command Return alkalmazásonként |
| Átnézés, mielőtt beérkezik | Ezen az oldalon nincs leírva | Review before inserting, alapból kikapcsolva |
Ha azt szeretnéd, hogy a diktálás a saját szkriptjeidet működtesse, a VoiceInk Custom Command olyat tud, amit a YapToText nem. Ha azt szeretnéd, hogy a szöveg a kurzornál jelenjen meg, a körülötte lévő szavakhoz igazítva, a YapToText ezt alapból megteszi, és nem kell hozzá szkript. A VoiceInk módjairól szóló oldal azt tárgyalja, hol állíthatók be a kimeneti módok, a VoiceInk és a superwhisper összehasonlítása pedig egy másik, módokra épülő alkalmazással veti össze.
Ingyen letölthető. Nincs fiók és nincsenek zárolt funkciók. Apple chippel szerelt Mac és macOS 14 vagy újabb kell hozzá. Forráskód a GitHubon.
A rövid változat
- Mi ez. Egy kimeneti mód, amely a végső szöveggel futtatja a shell parancsodat.
- A szöveg. A standard bemeneten és a $VOICEINK_TRANSCRIPT változóban.
- Korlátok. 10 másodperc, nincs bemenet, nincs automatikus beillesztés, csak élő diktálás.
- Hibakeresés. Az alkalmazásban nincs üzenet. Olvasd a naplót a fenti Terminal paranccsal.
- Innen indulj. Szerkeszd az öt sablon egyikét.
Ha a VoiceInk megváltoztatja a Custom Commands működését, nyiss egy issue-t a GitHubon, és frissítem az oldalt. Mindet elolvasom.
Ingyen letölthető. Nincs fiók és nincsenek zárolt funkciók. Apple chippel szerelt Mac és macOS 14 vagy újabb kell hozzá. Forráskód a GitHubon.
Útmutatók
További útmutatók, angolul
Források
- https://tryvoiceink.com/docs/custom-commands (ellenőrizve 2026. 10. 10.)
- https://tryvoiceink.com/docs/mode-settings (ellenőrizve 2026. 10. 10.)
- https://github.com/ryleighnewman/YapToText (ellenőrizve 2026. 10. 10.)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (ellenőrizve 2026. 10. 10.)
Kérdések
Mi az a Custom Command a VoiceInkben?
Egy kimeneti mód. A beillesztés helyett a VoiceInk lefuttat egy általad írt shell parancsot, és átadja neki a diktálás végső szövegét.
Hogyan kapja meg a szöveget a VoiceInk Custom Command?
A standard bemeneten és a $VOICEINK_TRANSCRIPT változóban, UTF-8 kódolással. Tedd idézőjelbe a változót, hogy a szóközök és a sortörések megmaradjanak.
Miért nem illesztett be semmit a VoiceInk Custom Commandem?
A Custom Command kimenet magától nem illeszt be. A parancsodnak kell kimásolnia vagy beillesztenie a szöveget, ahogy a Paste and Press Tab sablon teszi.
Meddig futhat egy VoiceInk Custom Command?
10 másodpercig. Utána a VoiceInk leállítja. Hosszabb munkához indíts háttérfolyamatot.
Van a YapToText-ben egyéni parancs, mint a VoiceInkben?
Nem futtat shell parancsokat diktálás után. A kurzornál beilleszt vagy begépel, csak a vágólapra is tud másolni, és a szöveg beérkezése után meg tudja nyomni a Return billentyűt.