VoiceInk Custom Commands: stuur je dictaat naar een script in plaats van het te plakken
Door Ryleigh Newman · Gepubliceerd op
Custom Command is een van de uitvoermodi van VoiceInk. In plaats van te plakken geeft VoiceInk de afgewerkte tekst van een dictaat aan een shellcommando dat jij schrijft, en dat commando bepaalt wat er gebeurt: de tekst toevoegen aan een notitie, een zoekopdracht openen, je eigen script aanroepen of de tekst naar een dienst sturen die je zelf draait. Het is het flexibelste wat VoiceInk met tekst doet, en er zijn een paar harde limieten die je beter kent voordat je erop bouwt.
Ik maak YapToText, een andere dicteerapp voor de Mac, dus lees wat ik over VoiceInk zeg met dat in gedachten. Elk feit over VoiceInk op deze pagina komt uit de eigen docs, gelezen op 10 oktober 2026.
Gratis te downloaden. Geen account, niets op slot, voor macOS 14 of nieuwer op een Mac met Apple chip. Broncode op GitHub.
Deze handleiding in andere talen: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Op deze pagina: 11 onderdelen
Wat het commando ontvangt
VoiceInk stuurt dezelfde definitieve tekst op twee manieren: via standaardinvoer en in de variabele $VOICEINK_TRANSCRIPT. De tekst is UTF-8, en de docs vragen je de variabele tussen aanhalingstekens te zetten, zodat spaties, leestekens en regeleinden behouden blijven.
- AI Enhancement uit. Het transcript na de opmaak en de woordvervangingen van VoiceInk.
- AI Enhancement aan en werkend. De verbeterde tekst.
- AI Enhancement overgeslagen of mislukt. Het gewone definitieve transcript.
Het commando krijgt nooit rechtstreeks de audio, de prompt, of de geselecteerde tekst, klembordtekst of schermtekst. Wil je dat context het resultaat vormt, dan zeggen de docs dat je een prompt en Context Awareness gebruikt, zodat die al in de definitieve tekst zit.
Hoe het draait
Uit de docs van VoiceInk, Custom Commands, gelezen op 10 oktober 2026.
| Onderdeel | Gedrag |
|---|---|
| Shell | /bin/zsh -lc |
| Time-out | 10 seconden, daarna stopt VoiceInk het commando |
| Rechten | Dezelfde macOS-gebruikersrechten als VoiceInk |
| Recorder | Wordt gesloten voordat het commando start |
| Gelukt | Exitcode 0. Al het andere telt als mislukt |
| Uitvoer | Standaarduitvoer en fouten worden bewaard voor diagnose en nooit in de app geplakt |
| Commando's die niet gevonden worden | VoiceInk probeert het PATH van je shell. Gebruik een volledig pad zoals /opt/homebrew/bin/tool als het mislukt |
De limieten waar mensen tegenaan lopen
- Er wordt niets voor je geplakt. Wil je de tekst toch in de app, dan moet je commando die zelf kopiëren of plakken.
- Tien seconden, geen vragen. Het commando kan niet op invoer wachten. Start voor langer werk je eigen achtergrondproces en sluit snel af.
- Het wijzigt het opgeslagen transcript niet. Wat het commando afdrukt wordt niet teruggeschreven.
- Geen Auto Send. Auto Send werkt alleen met Paste output, niet met Custom Command.
- Alleen live dicteren. Bestanden in de wachtrij van Transcribe file worden opgeslagen zonder dat uitvoercommando's draaien.
- Geen leeg commando. Een Mode met een leeg commando kan niet worden opgeslagen.
De ingebouwde sjablonen
Uit de docs van VoiceInk, Custom Commands, gelezen op 10 oktober 2026.
| Sjabloon | Wat het doet |
|---|---|
| Paste and Press Tab | Kopieert de tekst, plakt die en drukt dan op Tab |
| Lowercase and Paste | Zet de tekst in kleine letters, kopieert die en plakt die |
| Remove Trailing Period and Paste | Verwijdert één laatste punt voor het plakken |
| Append to Journal | Voegt de tekst toe aan ~/Documents/VoiceInk/journal.md |
| Search Web | Opent een zoekopdracht op internet met de tekst |
De docs raden aan met een sjabloon te beginnen en dat aan te passen. Twee van hun eenvoudigste voorbeelden, de tekst kopiëren en de tekst toevoegen aan een notitie:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Controleren of het gelukt is
VoiceInk toont na een Custom Command geen succes- of foutmelding. De docs geven een Terminal-commando dat de bezorglogs van de afgelopen 10 minuten toont, inclusief of het commando slaagde, mislukte of langer dan 10 seconden liep:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'De docs waarschuwen dat deze logs gedicteerde tekst kunnen bevatten. En stuurt je commando tekst naar een webdienst, dan ontvangt die dienst die tekst: VoiceInk voert alleen uit wat jij hebt ingesteld.
Waar YapToText staat
VoiceInk uit de docs, gelezen op 10 oktober 2026. YapToText uit de eigen instellingen.
| VoiceInk | YapToText | |
|---|---|---|
| Een shellcommando uitvoeren met de tekst | Ja, de uitvoer Custom Command | Nee |
| Plakken bij de cursor | Paste output | Plakken, de standaard |
| In plaats daarvan typen | Niet beschreven op deze pagina | Type character by character |
| Alleen het klembord | Met een commando zoals pbcopy | Copy to clipboard only |
| Daarna een toets indrukken | Sjabloon Paste and Press Tab | Return of Command Return per app |
| Nakijken voordat het landt | Niet beschreven op deze pagina | Review before inserting, standaard uit |
Wil je dat dicteren je eigen scripts aanstuurt, dan doet de Custom Command van VoiceInk iets wat YapToText niet doet. Wil je tekst bij de cursor, afgestemd op de woorden eromheen, dan doet YapToText dat standaard en heb je geen script nodig. De pagina over VoiceInk Modes behandelt waar uitvoermodi worden ingesteld, en VoiceInk tegenover superwhisper vergelijkt het met een andere app die rond modi is gebouwd.
Gratis te downloaden. Geen account, niets op slot, voor macOS 14 of nieuwer op een Mac met Apple chip. Broncode op GitHub.
Kort samengevat
- Wat het is. Een uitvoermodus die jouw shellcommando uitvoert met de definitieve tekst.
- De tekst. Via standaardinvoer en in $VOICEINK_TRANSCRIPT.
- Limieten. 10 seconden, geen invoer, niet automatisch plakken, alleen live dicteren.
- Debuggen. Geen melding in de app. Lees het log met het Terminal-commando hierboven.
- Begin hier. Pas een van de vijf sjablonen aan.
Verandert VoiceInk hoe Custom Commands werken, open dan een issue op GitHub en ik werk deze pagina bij. Ik lees ze allemaal.
Gratis te downloaden. Geen account, niets op slot, voor macOS 14 of nieuwer op een Mac met Apple chip. Broncode op GitHub.
Handleidingen
Meer handleidingen, in het Engels
Bronnen
- https://tryvoiceink.com/docs/custom-commands (bekeken op 10 oktober 2026)
- https://tryvoiceink.com/docs/mode-settings (bekeken op 10 oktober 2026)
- https://github.com/ryleighnewman/YapToText (bekeken op 10 oktober 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (bekeken op 10 oktober 2026)
Vragen
Wat is een Custom Command in VoiceInk?
Een uitvoermodus. In plaats van te plakken voert VoiceInk een shellcommando uit dat jij schrijft en geeft het de definitieve tekst van het dictaat door.
Hoe krijgt een Custom Command van VoiceInk de tekst?
Via standaardinvoer en in de variabele $VOICEINK_TRANSCRIPT, als UTF-8. Zet de variabele tussen aanhalingstekens om spaties en regeleinden te behouden.
Waarom plakte mijn Custom Command van VoiceInk niets?
De uitvoer van een Custom Command plakt niet uit zichzelf. Je commando moet de tekst zelf kopiëren of plakken, zoals het sjabloon Paste and Press Tab doet.
Hoe lang mag een Custom Command van VoiceInk draaien?
10 seconden. Daarna stopt VoiceInk het. Start voor langer werk een achtergrondproces.
Heeft YapToText custom commands zoals VoiceInk?
Het voert na een dictaat geen shellcommando's uit. Het plakt of typt bij de cursor, kan alleen naar het klembord kopiëren en kan op Return drukken nadat de tekst is geplaatst.