VoiceInk Custom Commands: skicka din diktering till ett skript i stället för att klistra in den

Av · Publicerad

Custom Command är ett av VoiceInks utdataläge. I stället för att klistra in ger VoiceInk den färdiga texten från en diktering till ett shell-kommando som du skriver, och kommandot avgör vad som händer: lägg till texten i en anteckning, öppna en sökning, anropa ditt eget skript eller skicka den till en tjänst som du driver. Det är det mest flexibla VoiceInk gör med text, och det har några hårda gränser som är bra att känna till innan du bygger på det.

Jag utvecklar YapToText, en annan dikteringsapp för Mac, så ha det i åtanke när du läser vad jag skriver om VoiceInk. Varje uppgift om VoiceInk här kommer från dess egna dokument, som jag läste den 10 oktober 2026.

Hämta YapToText i Mac App StoreGratis att hämta. Inget konto och inga låsta funktioner, för macOS 14 eller senare på en Mac med Apple-chip. Källkod på GitHub.

Den här guiden på andra språk: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文

Vad kommandot får

VoiceInk skickar samma färdiga text på två sätt: på standardinmatningen och i variabeln $VOICEINK_TRANSCRIPT. Texten är UTF-8, och dokumenten ber dig sätta variabeln inom citationstecken så att mellanrum, skiljetecken och radbrytningar överlever.

  • AI Enhancement av. Transkriptet efter VoiceInks formatering och ordersättningar.
  • AI Enhancement på och fungerar. Den förbättrade texten.
  • AI Enhancement hoppades över eller misslyckades. Det vanliga färdiga transkriptet.

Kommandot får aldrig ljudet, prompten eller den markerade texten, urklippstexten eller skärmtexten direkt. Om du vill att sammanhang ska påverka resultatet säger dokumenten att du ska använda en prompt och Context Awareness, så att det redan finns i den färdiga texten.

Så körs det

Från VoiceInks dokument, Custom Commands, läst den 10 oktober 2026.

DetaljBeteende
Shell/bin/zsh -lc
Tidsgräns10 sekunder, sedan stoppar VoiceInk kommandot
BehörigheterSamma macOS-användarbehörigheter som VoiceInk
InspelarenStängs innan kommandot startar
LyckatSlutkod 0. Allt annat räknas som ett misslyckande
UtdataStandardutdata och fel sparas för diagnostik och klistras aldrig in i appen
Kommandon som inte hittasVoiceInk försöker med din shells PATH. Använd en fullständig sökväg som /opt/homebrew/bin/tool om det misslyckas

Gränserna som överraskar

  • Inget klistras in åt dig. Om du ändå vill ha texten i appen måste ditt kommando själv kopiera eller klistra in den.
  • Tio sekunder och inga frågor. Kommandot kan inte vänta på inmatning. För längre arbete startar du en egen bakgrundsprocess och avslutar snabbt.
  • Det ändrar inte det sparade transkriptet. Det kommandot skriver ut skrivs inte tillbaka.
  • Ingen Auto Send. Auto Send fungerar bara med Paste som utdata, inte med Custom Command.
  • Bara levande diktering. Filer i kön för Transcribe file sparas utan att utdatakommandon körs.
  • Inget tomt kommando. Ett läge (Mode) med ett tomt kommando kan inte sparas.

De inbyggda mallarna

Från VoiceInks dokument, Custom Commands, läst den 10 oktober 2026.

MallVad den gör
Paste and Press TabKopierar texten, klistrar in den och trycker sedan på Tab
Lowercase and PasteGör texten till gemener, kopierar den och klistrar sedan in den
Remove Trailing Period and PasteTar bort en sista punkt innan texten klistras in
Append to JournalLägger till texten i ~/Documents/VoiceInk/journal.md
Search WebÖppnar en webbsökning på texten

Dokumenten föreslår att du börjar från en mall och redigerar den. Två av deras enklaste exempel, att kopiera texten och att lägga till den i en anteckning:

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

Kontrollera om det fungerade

VoiceInk visar inget meddelande om lyckat eller misslyckat efter ett Custom Command. Dokumenten ger ett Terminal-kommando som visar de senaste 10 minuternas leveransloggar, med uppgift om kommandot lyckades, misslyckades eller tog längre tid än 10 sekunder:

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

Dokumenten varnar för att loggarna kan innehålla dikterad text. Och om ditt kommando skickar text till en webbtjänst får tjänsten den: VoiceInk kör bara det du har ställt in.

Hur det ser ut i YapToText

VoiceInk från dess dokument, läst den 10 oktober 2026. YapToText från dess egna inställningar.

VoiceInkYapToText
Köra ett shell-kommando med textenJa, utdata Custom CommandNej
Klistra in vid markörenPaste som utdataPaste, standardvalet
Skriva ut den i ställetBeskrivs inte på den här sidanType character by character
Bara urklippMed ett kommando som pbcopyCopy to clipboard only
Trycka på en tangent efteråtMallen Paste and Press TabReturn eller Command Return per app
Granska innan den hamnar i textenBeskrivs inte på den här sidanReview before inserting, av från början

Om du vill att dikteringen ska styra dina egna skript gör VoiceInks Custom Command något som YapToText inte gör. Om du vill ha text vid markören, formad efter orden runt omkring, gör YapToText det från början och behöver inget skript. Sidan om VoiceInks lägen tar upp var utdataläge ställs in, och VoiceInk jämfört med superwhisper jämför det med en annan app som bygger på lägen.

Hämta YapToText i Mac App StoreGratis att hämta. Inget konto och inga låsta funktioner, för macOS 14 eller senare på en Mac med Apple-chip. Källkod på GitHub.

Kort sammanfattat

  • Vad det är. Ett utdataläge som kör ditt shell-kommando med den färdiga texten.
  • Texten. På standardinmatningen och i $VOICEINK_TRANSCRIPT.
  • Gränser. 10 sekunder, ingen inmatning, ingen automatisk inklistring, bara levande diktering.
  • Felsökning. Inget meddelande i appen. Läs loggen med Terminal-kommandot ovan.
  • Börja här. Redigera en av de fem mallarna.

Om VoiceInk ändrar hur Custom Commands fungerar, öppna ett issue på GitHub så uppdaterar jag sidan. Jag läser alla.

Hämta YapToText i Mac App StoreGratis att hämta. Inget konto och inga låsta funktioner, för macOS 14 eller senare på en Mac med Apple-chip. Källkod på GitHub.

Vem som skriver. Ryleigh Newman utvecklar programvara, har svårt att skriva på tangentbord och dikterar varje dag med YapToText, appen som den här webbplatsen handlar om. Sidan är översatt från engelska. Appens gränssnitt och resten av webbplatsen är på engelska. Mer om projektet, på engelska.

Guider

Fler guider, på engelska

Källor

Frågor

Vad är ett Custom Command i VoiceInk?

Ett utdataläge. I stället för att klistra in kör VoiceInk ett shell-kommando som du skriver och ger det dikteringens färdiga text.

Hur får ett VoiceInk Custom Command texten?

På standardinmatningen och i variabeln $VOICEINK_TRANSCRIPT, som UTF-8. Sätt variabeln inom citationstecken för att behålla mellanrum och radbrytningar.

Varför klistrade mitt VoiceInk Custom Command inte in något?

Utdata från Custom Command klistrar inte in av sig själv. Ditt kommando måste själv kopiera eller klistra in texten, som mallen Paste and Press Tab gör.

Hur länge får ett VoiceInk Custom Command köras?

10 sekunder. Sedan stoppar VoiceInk det. Starta en bakgrundsprocess för längre arbete.

Har YapToText egna kommandon som VoiceInk?

Nej, det kör inga shell-kommandon efter en diktering. Det klistrar in eller skriver ut vid markören, kan bara kopiera till urklipp och kan trycka på Return när texten har hamnat.