VoiceInk Custom Commands: wyślij dyktowanie do skryptu zamiast je wklejać
Tekst: Ryleigh Newman · Opublikowano
Custom Command (polecenie własne) to jeden z trybów wyjścia w VoiceInk. Zamiast wklejać, VoiceInk przekazuje gotowy tekst dyktowania do napisanego przez Ciebie polecenia powłoki, a to polecenie decyduje, co się dzieje: dopisuje tekst do notatki, otwiera wyszukiwanie, wywołuje Twój skrypt albo wysyła go do usługi, którą prowadzisz. To najbardziej elastyczna rzecz, jaką VoiceInk robi z tekstem, i ma kilka twardych limitów, które warto znać, zanim coś na tym zbudujesz.
Za YapToText, inną aplikację do dyktowania na Maca, odpowiadam ja, więc czytaj to, co piszę o VoiceInk, z tą wiedzą. Każdy fakt o VoiceInk pochodzi tu z jego własnej dokumentacji, czytanej 10 października 2026.
Do pobrania za darmo. Bez konta i bez blokad, dla macOS 14 lub nowszego na Macu z układem Apple. Kod źródłowy na GitHubie.
Ten poradnik w innych językach: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Co otrzymuje polecenie
VoiceInk wysyła ten sam gotowy tekst dwoma drogami: na standardowe wejście i w zmiennej $VOICEINK_TRANSCRIPT. Tekst jest w UTF-8, a dokumentacja prosi, żeby zmienną ujmować w cudzysłów, dzięki czemu przetrwają spacje, interpunkcja i podziały wierszy.
- Gdy AI Enhancement jest wyłączone. Transkrypcja po formatowaniu VoiceInk i zamianie słów.
- Gdy AI Enhancement jest włączone i działa. Tekst po ulepszeniu.
- Gdy AI Enhancement zostało pominięte albo się nie udało. Zwykła gotowa transkrypcja.
Polecenie nigdy nie dostaje bezpośrednio dźwięku, promptu ani zaznaczonego tekstu, tekstu ze schowka czy z ekranu. Jeśli chcesz, żeby kontekst wpływał na wynik, dokumentacja radzi użyć promptu i Context Awareness, tak aby był już w gotowym tekście.
Jak jest uruchamiane
Z dokumentacji VoiceInk, Custom Commands, czytanej 10 października 2026.
| Szczegół | Zachowanie |
|---|---|
| Powłoka | /bin/zsh -lc |
| Limit czasu | 10 sekund, potem VoiceInk zatrzymuje polecenie |
| Uprawnienia | Te same uprawnienia użytkownika macOS co VoiceInk |
| Rejestrator | Zamykany, zanim polecenie ruszy |
| Powodzenie | Kod wyjścia 0. Wszystko inne liczy się jako niepowodzenie |
| Wynik | Standardowe wyjście i błędy są zachowywane do diagnostyki, nigdy nie są wklejane do aplikacji |
| Nieznalezione polecenia | VoiceInk próbuje PATH Twojej powłoki. Jeśli to zawiedzie, użyj pełnej ścieżki, takiej jak /opt/homebrew/bin/tool |
Limity, na których ludzie się potykają
- Nic nie jest wklejane za Ciebie. Jeśli nadal chcesz mieć tekst w aplikacji, Twoje polecenie samo musi go skopiować lub wkleić.
- Dziesięć sekund i żadnych pytań. Polecenie nie może czekać na dane wejściowe. Przy dłuższej pracy uruchom własny proces w tle i szybko zakończ.
- Nie zmienia zapisanej transkrypcji. To, co polecenie wypisze, nie jest zapisywane z powrotem.
- Brak Auto Send. Auto Send działa tylko z wyjściem Paste, a nie z Custom Command.
- Tylko dyktowanie na żywo. Pliki w kolejce Transcribe file są zapisywane bez uruchamiania poleceń wyjścia.
- Brak pustego polecenia. Trybu (Mode) z pustym poleceniem nie da się zapisać.
Wbudowane szablony
Z dokumentacji VoiceInk, Custom Commands, czytanej 10 października 2026.
| Szablon | Co robi |
|---|---|
| Paste and Press Tab | Kopiuje tekst, wkleja go, a potem naciska Tab |
| Lowercase and Paste | Zamienia tekst na małe litery, kopiuje go, a potem wkleja |
| Remove Trailing Period and Paste | Usuwa jedną końcową kropkę przed wklejeniem |
| Append to Journal | Dodaje tekst do ~/Documents/VoiceInk/journal.md |
| Search Web | Otwiera wyszukiwanie w sieci dla tego tekstu |
Dokumentacja radzi zacząć od szablonu i go edytować. Dwa z jej najprostszych przykładów: skopiowanie tekstu i dopisanie go do notatki:
printf "%s" "$VOICEINK_TRANSCRIPT" | pbcopymkdir -p "$HOME/Documents/VoiceInk"
printf -- "- %s\n" "$VOICEINK_TRANSCRIPT" >> "$HOME/Documents/VoiceInk/notes.md"Sprawdzanie, czy zadziałało
VoiceInk nie pokazuje komunikatu o powodzeniu ani niepowodzeniu po poleceniu Custom Command. Dokumentacja podaje polecenie Terminala, które pokazuje dzienniki dostarczania z ostatnich 10 minut, w tym to, czy polecenie się udało, zawiodło albo przekroczyło 10 sekund:
/usr/bin/log show --last 10m --style compact \
--predicate 'subsystem == "com.prakashjoshipax.voiceink" AND category == "TranscriptionDelivery"'Dokumentacja ostrzega, że te dzienniki mogą zawierać podyktowany tekst. A jeśli Twoje polecenie wysyła tekst do usługi internetowej, ta usługa go dostaje, bo VoiceInk uruchamia tylko to, co skonfigurowano.
Gdzie jest YapToText
VoiceInk według dokumentacji, czytanej 10 października 2026. YapToText według własnych ustawień.
| VoiceInk | YapToText | |
|---|---|---|
| Uruchomienie polecenia powłoki z tekstem | Tak, wyjście Custom Command | Nie |
| Wklejenie w miejscu kursora | Wyjście Paste | Paste, domyślnie |
| Wpisanie zamiast wklejenia | Ta strona tego nie opisuje | Type character by character |
| Tylko schowek | Poleceniem takim jak pbcopy | Copy to clipboard only |
| Naciśnięcie klawisza po wstawieniu | Szablon Paste and Press Tab | Return lub Command Return dla każdej aplikacji |
| Przejrzenie, zanim tekst wyląduje | Ta strona tego nie opisuje | Review before inserting, domyślnie wyłączone |
Jeśli chcesz, żeby dyktowanie sterowało Twoimi skryptami, Custom Command w VoiceInk robi coś, czego YapToText nie robi. Jeśli chcesz tekst w miejscu kursora, dopasowany do otaczających go słów, YapToText robi to domyślnie i nie potrzebuje skryptu. O tym, gdzie ustawia się tryby wyjścia, mówi strona o trybach VoiceInk, a VoiceInk kontra superwhisper porównuje go z inną aplikacją opartą na trybach.
Do pobrania za darmo. Bez konta i bez blokad, dla macOS 14 lub nowszego na Macu z układem Apple. Kod źródłowy na GitHubie.
W skrócie
- Czym jest. Tryb wyjścia, który uruchamia Twoje polecenie powłoki z gotowym tekstem.
- Tekst. Na standardowym wejściu i w $VOICEINK_TRANSCRIPT.
- Limity. 10 sekund, brak wejścia, brak automatycznego wklejania, tylko dyktowanie na żywo.
- Debugowanie. Brak komunikatu w aplikacji. Przeczytaj dziennik poleceniem Terminala powyżej.
- Zacznij tu. Edytuj jeden z pięciu szablonów.
Jeśli VoiceInk zmieni działanie Custom Commands, zgłoś to na GitHubie, a zaktualizuję tę stronę. Czytam każde zgłoszenie.
Do pobrania za darmo. Bez konta i bez blokad, dla macOS 14 lub nowszego na Macu z układem Apple. Kod źródłowy na GitHubie.
Poradniki
Więcej poradników, po angielsku
Źródła
- https://tryvoiceink.com/docs/custom-commands (sprawdzono 10 października 2026)
- https://tryvoiceink.com/docs/mode-settings (sprawdzono 10 października 2026)
- https://github.com/ryleighnewman/YapToText (sprawdzono 10 października 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (sprawdzono 10 października 2026)
Pytania
Czym jest Custom Command w VoiceInk?
Trybem wyjścia. Zamiast wklejać, VoiceInk uruchamia napisane przez Ciebie polecenie powłoki i przekazuje mu gotowy tekst dyktowania.
Jak Custom Command w VoiceInk dostaje tekst?
Na standardowym wejściu i w zmiennej $VOICEINK_TRANSCRIPT, w UTF-8. Ujmij zmienną w cudzysłów, aby zachować spacje i podziały wierszy.
Dlaczego mój Custom Command w VoiceInk niczego nie wkleił?
Wyjście Custom Command nie wkleja samo. Twoje polecenie musi samo skopiować lub wkleić tekst, tak jak robi to szablon Paste and Press Tab.
Jak długo może działać Custom Command w VoiceInk?
10 sekund. Potem VoiceInk go zatrzymuje. Przy dłuższej pracy uruchom proces w tle.
Czy YapToText ma własne polecenia jak VoiceInk?
Nie uruchamia poleceń powłoki po dyktowaniu. Wkleja lub wpisuje w miejscu kursora, potrafi tylko skopiować do schowka i może nacisnąć Return po wstawieniu tekstu.