VoiceInk Custom Commands: send din diktering til et script i stedet for at indsætte den

Custom Command (brugerdefineret kommando) er en af VoiceInks outputtilstande. I stedet for at indsætte teksten sender VoiceInk den færdige tekst fra en diktering til en shell-kommando, du selv skriver, og kommandoen afgør, hvad der sker: tilføj teksten til en note, åbn en søgning, kald dit eget script eller send den til en tjeneste, du selv driver. Det er det mest fleksible, VoiceInk kan gøre med tekst, og det har nogle faste grænser, som er værd at kende, før du bygger videre på det.

Jeg har lavet YapToText, en anden dikteringsapp til Mac, så læs det, jeg skriver om VoiceInk, med det i mente. Alle fakta om VoiceInk her kommer fra appens egen dokumentation, læst den 10. oktober 2026.

Hent YapToText i Mac App StoreGratis at hente. Ingen konto og ingen låste funktioner, til macOS 14 eller nyere på en Mac med Apple-chip. Kildekode på GitHub.

Det får kommandoen

VoiceInk sender den samme færdige tekst på to måder: til standardinput og i variablen $VOICEINK_TRANSCRIPT. Teksten er UTF-8, og dokumentationen beder dig sætte variablen i anførselstegn, så mellemrum, tegnsætning og linjeskift overlever.

  • AI Enhancement slået fra. Transskriptionen efter VoiceInks formatering og orderstatninger.
  • AI Enhancement slået til og virker. Den forbedrede tekst.
  • AI Enhancement sprunget over eller fejlet. Den almindelige færdige transskription.

Kommandoen får aldrig lyden, prompten eller den markerede tekst, udklipsholderen eller skærmteksten direkte. Hvis du vil have kontekst med i resultatet, siger dokumentationen, at du skal bruge en prompt og Context Awareness, så den allerede ligger i den færdige tekst.

Sådan kører den

Fra VoiceInks dokumentation, Custom Commands, læst den 10. oktober 2026.

DetaljeOpførsel
Shell/bin/zsh -lc
Tidsgrænse10 sekunder, derefter stopper VoiceInk kommandoen
TilladelserDe samme macOS-brugertilladelser som VoiceInk
OptagerenLukkes, før kommandoen starter
SuccesAfslutningskode 0. Alt andet tæller som en fejl
OutputStandardoutput og fejl gemmes til diagnose og indsættes aldrig i appen
Kommandoer, der ikke findesVoiceInk prøver din shells PATH. Brug en fuld sti som /opt/homebrew/bin/tool, hvis det mislykkes

De grænser, der fanger folk

  • Intet bliver indsat for dig. Vil du stadig have teksten i appen, skal din kommando selv kopiere eller indsætte den.
  • Ti sekunder, ingen spørgsmål. Kommandoen kan ikke vente på input. Til længere arbejde starter du din egen baggrundsproces og afslutter hurtigt.
  • Den ændrer ikke den gemte transskription. Det, kommandoen udskriver, skrives ikke tilbage.
  • Ingen Auto Send. Auto Send virker kun med Paste som output, ikke med Custom Command.
  • Kun live diktering. Filer i køen under Transcribe file gemmes uden at køre outputkommandoer.
  • Ingen tom kommando. En Mode (tilstand) med en tom kommando kan ikke gemmes.

De indbyggede skabeloner

Fra VoiceInks dokumentation, Custom Commands, læst den 10. oktober 2026.

SkabelonHvad den gør
Paste and Press TabKopierer teksten, indsætter den og trykker derefter på Tab
Lowercase and PasteGør teksten til små bogstaver, kopierer den og indsætter den
Remove Trailing Period and PasteFjerner ét afsluttende punktum, før teksten indsættes
Append to JournalTilføjer teksten til ~/Documents/VoiceInk/journal.md
Search WebÅbner en websøgning efter teksten

Dokumentationen foreslår, at du starter fra en skabelon og redigerer den. To af de enkleste eksempler er at kopiere teksten og at tilføje den til en note:

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

Sådan tjekker du, om det virkede

VoiceInk viser ingen besked om succes eller fejl efter en Custom Command. Dokumentationen har en Terminal-kommando, der viser de seneste 10 minutters leveringslogge, blandt andet om kommandoen lykkedes, fejlede eller kørte længere end 10 sekunder:

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

Dokumentationen advarer om, at disse logge kan indeholde dikteret tekst. Og hvis din kommando sender tekst til en webtjeneste, så modtager tjenesten den: VoiceInk kører kun det, du har sat op.

Hvor YapToText står

VoiceInk fra dokumentationen, læst den 10. oktober 2026. YapToText fra appens egne indstillinger.

VoiceInkYapToText
Kør en shell-kommando med tekstenJa, output med Custom CommandNej
Indsæt ved markørenPaste som outputPaste, standarden
Skriv den i stedetIkke beskrevet på denne sideType character by character
Kun udklipsholderenMed en kommando som pbcopyCopy to clipboard only
Tryk på en tast bagefterSkabelonen Paste and Press TabReturn eller Command Return pr. app
Gennemse, før teksten landerIkke beskrevet på denne sideReview before inserting, slået fra som standard

Hvis du vil have dikteringen til at styre dine egne scripts, kan Custom Command i VoiceInk noget, som YapToText ikke kan. Vil du have tekst ved markøren, formet efter ordene omkring den, gør YapToText det som standard og kræver intet script. Siden om VoiceInk Modes viser, hvor outputtilstande sættes, og VoiceInk mod superwhisper sammenligner den med en anden app bygget om tilstande.

Hent YapToText i Mac App StoreGratis at hente. Ingen konto og ingen låste funktioner, til macOS 14 eller nyere på en Mac med Apple-chip. Kildekode på GitHub.

Kort fortalt

  • Hvad det er. En outputtilstand, der kører din shell-kommando med den færdige tekst.
  • Teksten. På standardinput og i $VOICEINK_TRANSCRIPT.
  • Grænser. 10 sekunder, intet input, ingen automatisk indsættelse, kun live diktering.
  • Fejlsøgning. Ingen besked i appen. Læs loggen med Terminal-kommandoen ovenfor.
  • Start her. Rediger en af de fem skabeloner.

Hvis VoiceInk ændrer, hvordan Custom Commands virker, så opret et issue på GitHub, og jeg opdaterer siden. Jeg læser dem alle.

Hent YapToText i Mac App StoreGratis at hente. Ingen konto og ingen låste funktioner, til macOS 14 eller nyere på en Mac med Apple-chip. Kildekode på GitHub.

Hvem der skriver. Ryleigh Newman udvikler software, har svært ved at skrive på tastatur og dikterer hver dag med YapToText, den app, som dette websted handler om. Siden er oversat fra engelsk. Appens brugerflade og resten af webstedet er på engelsk. Mere om projektet, på engelsk.

Vejledninger

Flere vejledninger, på engelsk

Kilder

Spørgsmål

Hvad er en Custom Command i VoiceInk?

En outputtilstand. I stedet for at indsætte kører VoiceInk en shell-kommando, du selv skriver, og giver den dikteringens færdige tekst.

Hvordan får en VoiceInk Custom Command teksten?

På standardinput og i variablen $VOICEINK_TRANSCRIPT, som UTF-8. Sæt variablen i anførselstegn for at bevare mellemrum og linjeskift.

Hvorfor indsatte min VoiceInk Custom Command ikke noget?

Output med Custom Command indsætter ikke selv. Din kommando skal selv kopiere eller indsætte teksten, som skabelonen Paste and Press Tab gør.

Hvor længe kan en VoiceInk Custom Command køre?

10 sekunder. Derefter stopper VoiceInk den. Start en baggrundsproces til længere arbejde.

Har YapToText brugerdefinerede kommandoer som VoiceInk?

Den kører ingen shell-kommandoer efter en diktering. Den indsætter eller skriver ved markøren, kan kun kopiere til udklipsholderen og kan trykke på Return, når teksten er landet.