VoiceInk Custom Commands: lähetä sanelusi skriptille liittämisen sijaan
Teksti: Ryleigh Newman · Julkaistu
Custom Command (oma komento) on yksi VoiceInkin tulostetiloista. Liittämisen sijaan VoiceInk antaa sanelun valmiin tekstin kirjoittamallesi komentotulkin komennolle, ja komento päättää, mitä tapahtuu: lisää se muistiinpanoon, avaa haku, kutsu omaa skriptiäsi tai lähetä se ylläpitämääsi palveluun. Se on joustavin asia, jonka VoiceInk tekee tekstillä, ja siinä on muutama kova raja, jotka kannattaa tuntea ennen rakentamista.
Tein YapToTextin, toisen sanelusovelluksen Macille, joten lue VoiceInkista kirjoittamani sitä silmällä pitäen. Kaikki VoiceInkia koskevat tiedot tällä sivulla ovat sen omista ohjeista, jotka luin 10. lokakuuta 2026.
Ladattavissa ilmaiseksi. Ei tiliä eikä lukittuja ominaisuuksia. Vaatii macOS 14:n tai uudemman ja Macin, jossa on Applen siru. Lähdekoodi GitHubissa.
Tämä opas muilla kielillä: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Mitä komento saa
VoiceInk lähettää saman lopullisen tekstin kahta kautta: vakiosyötteenä ja muuttujassa $VOICEINK_TRANSCRIPT. Teksti on UTF-8-muotoista, ja ohjeet pyytävät lainaamaan muuttujan, jotta välilyönnit, välimerkit ja rivinvaihdot säilyvät.
- AI Enhancement (tekoälyparannus) pois päältä. Komento saa litteroinnin VoiceInkin muotoilun ja sanakorvausten jälkeen.
- AI Enhancement päällä ja toimii. Komento saa parannetun tekstin.
- AI Enhancement ohitettu tai epäonnistui. Komento saa tavallisen lopullisen litteroinnin.
Komento ei koskaan saa ääntä, kehotetta eikä valittua, leikepöydän tai näytön tekstiä suoraan. Jos haluat kontekstin vaikuttavan tulokseen, ohjeiden mukaan käytä kehotetta (Prompt) ja toimintoa Context Awareness, jolloin konteksti on jo lopullisessa tekstissä.
Miten se ajetaan
VoiceInkin ohjeista, Custom Commands, luettu 10. lokakuuta 2026.
| Yksityiskohta | Toiminta |
|---|---|
| Komentotulkki | /bin/zsh -lc |
| Aikaraja | 10 sekuntia, sen jälkeen VoiceInk pysäyttää komennon |
| Oikeudet | Samat macOS-käyttäjäoikeudet kuin VoiceInkillä |
| Nauhoitin | Suljetaan ennen komennon käynnistymistä |
| Onnistuminen | Paluukoodi 0. Mikä tahansa muu lasketaan epäonnistumiseksi |
| Tuloste | Vakiotuloste ja virheet säilytetään vianmääritystä varten, mutta niitä ei koskaan liitetä appiin |
| Komentoa ei löydy | VoiceInk kokeilee komentotulkkisi PATH-polkua. Käytä koko polkua, kuten /opt/homebrew/bin/tool, jos se epäonnistuu |
Rajat, jotka yllättävät
- Mitään ei liitetä puolestasi. Jos haluat tekstin silti appiin, komennon täytyy kopioida tai liittää se itse.
- Kymmenen sekuntia, ei kysymyksiä. Komento ei voi odottaa syötettä. Pidempää työtä varten käynnistä oma taustaprosessi ja poistu nopeasti.
- Se ei muuta tallennettua litterointia. Mitä komento tulostaa, sitä ei kirjoiteta takaisin.
- Ei toimintoa Auto Send. Toiminto Auto Send toimii vain tulosteella Paste output, ei tilalla Custom Command.
- Vain suora sanelu. Jonon Transcribe file tiedostot tallennetaan ajamatta tulostekomentoja.
- Ei tyhjää komentoa. Tilaa (Mode), jonka komento on tyhjä, ei voi tallentaa.
Sisäänrakennetut pohjat
VoiceInkin ohjeista, Custom Commands, luettu 10. lokakuuta 2026.
| Pohja | Mitä se tekee |
|---|---|
| Paste and Press Tab | Kopioi tekstin, liittää sen ja painaa sitten Tab-näppäintä |
| Lowercase and Paste | Muuttaa tekstin pieniksi kirjaimiksi, kopioi sen ja liittää sen |
| Remove Trailing Period and Paste | Poistaa yhden viimeisen pisteen ennen liittämistä |
| Append to Journal | Lisää tekstin tiedostoon ~/Documents/VoiceInk/journal.md |
| Search Web | Avaa verkkohaun tekstille |
Ohjeet ehdottavat, että aloitat pohjasta ja muokkaat sitä. Kaksi niiden yksinkertaisinta esimerkkiä: tekstin kopioiminen ja sen lisääminen muistiinpanoon.
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Onnistumisen tarkistaminen
VoiceInk ei näytä onnistumis- eikä epäonnistumisviestiä oman komennon jälkeen. Ohjeissa on päätteessä ajettava komento, joka näyttää viimeisen 10 minuutin toimituslokit, myös sen, onnistuiko komento, epäonnistuiko se vai ylittikö se 10 sekuntia:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'Ohjeet varoittavat, että nämä lokit voivat sisältää sanellun tekstin. Ja jos komentosi lähettää tekstiä verkkopalveluun, palvelu saa sen, koska VoiceInk ajaa vain sen, minkä olet määrittänyt.
Missä YapToText on
VoiceInk sen ohjeista, luettu 10. lokakuuta 2026. YapToText omista asetuksistaan.
| VoiceInk | YapToText | |
|---|---|---|
| Aja komentotulkin komento tekstillä | Kyllä, tulostetila Custom Command | Ei |
| Liitä kohdistimen kohtaan | Paste output | Paste, oletus |
| Kirjoita se sen sijaan | Ei kuvattu tällä sivulla | Type character by character |
| Vain leikepöydälle | Komennolla, kuten pbcopy | Copy to clipboard only |
| Paina näppäintä jälkeenpäin | Pohja Paste and Press Tab | Return tai Command Return appikohtaisesti |
| Tarkista ennen kuin teksti laskeutuu | Ei kuvattu tällä sivulla | Review before inserting, oletuksena pois päältä |
Jos haluat sanelun ohjaavan omia skriptejäsi, VoiceInkin Custom Command tekee jotain, mitä YapToText ei tee. Jos haluat tekstin kohdistimen kohdalle sen ympärillä olevien sanojen mukaan muotoiltuna, YapToText tekee sen oletuksena eikä tarvitse skriptiä. VoiceInkin Modes-sivu kertoo, missä tulostetilat asetetaan, ja VoiceInk ja superwhisper vertailussa vertaa sitä toiseen tiloihin perustuvaan appiin.
Ladattavissa ilmaiseksi. Ei tiliä eikä lukittuja ominaisuuksia. Vaatii macOS 14:n tai uudemman ja Macin, jossa on Applen siru. Lähdekoodi GitHubissa.
Lyhyesti
- Mikä se on. Tulostetila, joka ajaa komentotulkin komentosi lopullisella tekstillä.
- Teksti. Vakiosyötteessä ja muuttujassa $VOICEINK_TRANSCRIPT.
- Rajat. 10 sekuntia, ei syötettä, ei automaattista liittämistä, vain suora sanelu.
- Vianmääritys. Appissa ei ole viestiä. Lue loki yllä olevalla päätekomennolla.
- Aloita tästä. Muokkaa yhtä viidestä pohjasta.
Jos VoiceInk muuttaa Custom Commandien toimintaa, avaa issue GitHub-palvelussa (englanniksi) ja päivitän tämän sivun. Luen jokaisen.
Ladattavissa ilmaiseksi. Ei tiliä eikä lukittuja ominaisuuksia. Vaatii macOS 14:n tai uudemman ja Macin, jossa on Applen siru. Lähdekoodi GitHubissa.
Oppaat
Lisää oppaita, englanniksi
Lähteet
- https://tryvoiceink.com/docs/custom-commands (tarkistettu 10.10.2026)
- https://tryvoiceink.com/docs/mode-settings (tarkistettu 10.10.2026)
- https://github.com/ryleighnewman/YapToText (tarkistettu 10.10.2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (tarkistettu 10.10.2026)
Kysymyksiä
Mikä on Custom Command VoiceInkissa?
Tulostetila. Liittämisen sijaan VoiceInk ajaa kirjoittamasi komentotulkin komennon ja antaa sille sanelun lopullisen tekstin.
Miten VoiceInkin Custom Command saa tekstin?
Vakiosyötteenä ja muuttujassa $VOICEINK_TRANSCRIPT UTF-8-muodossa. Lainaa muuttuja, jotta välilyönnit ja rivinvaihdot säilyvät.
Miksi VoiceInkin Custom Command ei liittänyt mitään?
Custom Command -tuloste ei liitä itsestään. Komentosi täytyy kopioida tai liittää teksti itse, kuten pohja Paste and Press Tab tekee.
Kuinka pitkään VoiceInkin Custom Command voi ajaa?
10 sekuntia. Sen jälkeen VoiceInk pysäyttää sen. Pidempää työtä varten käynnistä taustaprosessi.
Onko YapToTextissa omia komentoja kuten VoiceInkissa?
Se ei aja komentotulkin komentoja sanelun jälkeen. Se liittää tai kirjoittaa tekstin kohdistimen kohtaan, voi kopioida vain leikepöydälle ja voi painaa Returniä tekstin laskeuduttua.