VoiceInk Custom Command: 받아쓴 내용을 붙여넣는 대신 스크립트로 보내기

글쓴이 · 게시일

Custom Command는 VoiceInk의 출력 모드 중 하나입니다. 붙여넣는 대신, VoiceInk가 받아쓰기를 마친 텍스트를 직접 작성한 셸 명령에 넘기고, 그 이후의 일은 명령이 정합니다. 노트에 덧붙이거나, 검색을 열거나, 자신의 스크립트를 호출하거나, 직접 운영하는 서비스로 보낼 수 있습니다. VoiceInk가 텍스트로 할 수 있는 일 중 가장 유연하지만, 만들기 전에 알아 두어야 할 몇 가지 확실한 제한이 있습니다.

저는 Mac용 다른 받아쓰기 앱 YapToText를 만들고 있으니, VoiceInk에 관한 제 설명은 그 점을 감안하고 읽어 주세요. 여기 있는 VoiceInk에 관한 내용은 모두 2026년 10월 10일에 읽은 공식 문서에서 가져왔습니다.

Mac App Store에서 YapToText 다운로드무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.

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

명령이 받는 것

VoiceInk는 같은 최종 텍스트를 두 가지 방법으로 보냅니다. 표준 입력과 변수 $VOICEINK_TRANSCRIPT입니다. 텍스트는 UTF-8이며, 문서는 공백, 구두점, 줄바꿈이 유지되도록 변수를 따옴표로 감싸라고 안내합니다.

  • AI Enhancement가 꺼져 있을 때. VoiceInk의 서식 처리와 단어 치환을 거친 받아쓰기 결과입니다.
  • AI Enhancement가 켜져 있고 작동했을 때. 다듬어진 텍스트입니다.
  • AI Enhancement를 건너뛰었거나 실패했을 때. 가공하지 않은 최종 받아쓰기 결과입니다.

명령은 오디오, 프롬프트, 선택한 텍스트, 클립보드, 화면 텍스트를 직접 받지 않습니다. 맥락이 결과에 반영되기를 원한다면, 문서는 프롬프트와 Context Awareness를 써서 이미 최종 텍스트에 들어 있게 하라고 안내합니다.

실행되는 방식

VoiceInk 문서 Custom Commands에서 2026년 10월 10일에 읽은 내용입니다.

항목동작
셸/bin/zsh -lc
제한 시간10초이며, 이후 VoiceInk가 명령을 중단합니다
권한VoiceInk와 같은 macOS 사용자 권한입니다
녹음 창명령이 시작되기 전에 닫힙니다
성공종료 코드 0입니다. 그 외에는 모두 실패로 처리됩니다
출력표준 출력과 오류는 진단용으로 보관되고, 앱에 붙여넣어지지 않습니다
명령을 찾지 못할 때VoiceInk는 셸의 PATH를 시도합니다. 실패하면 /opt/homebrew/bin/tool 같은 전체 경로를 쓰세요

사람들이 자주 걸리는 제한

  • 자동으로 붙여넣어지지 않습니다. 그래도 앱에 텍스트가 들어가기를 원한다면 명령이 직접 복사하거나 붙여넣어야 합니다.
  • 10초이고, 질문은 할 수 없습니다. 명령은 입력을 기다릴 수 없습니다. 더 오래 걸리는 작업은 별도의 백그라운드 프로세스를 시작하고 바로 끝내세요.
  • 저장된 받아쓰기 내용은 바뀌지 않습니다. 명령이 출력하는 내용은 다시 기록되지 않습니다.
  • Auto Send는 없습니다. Auto Send는 Paste 출력에서만 작동하고 Custom Command에서는 작동하지 않습니다.
  • 실시간 받아쓰기만 해당합니다. Transcribe file 대기열의 파일은 출력 명령을 실행하지 않고 저장됩니다.
  • 빈 명령은 안 됩니다. 명령이 비어 있는 Mode는 저장할 수 없습니다.

기본 제공 템플릿

VoiceInk 문서 Custom Commands에서 2026년 10월 10일에 읽은 내용입니다.

템플릿하는 일
Paste and Press Tab텍스트를 복사하고 붙여넣은 뒤 Tab 키를 누릅니다
Lowercase and Paste텍스트를 소문자로 바꾸고 복사한 뒤 붙여넣습니다
Remove Trailing Period and Paste마지막 마침표 하나를 뺀 뒤 붙여넣습니다
Append to Journal텍스트를 ~/Documents/VoiceInk/journal.md에 추가합니다
Search Web텍스트로 웹 검색을 엽니다

문서는 템플릿에서 시작해 고쳐 쓰라고 제안합니다. 가장 간단한 두 가지 예는 텍스트를 복사하는 것과 노트에 덧붙이는 것입니다.

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

제대로 실행됐는지 확인하기

VoiceInk는 Custom Command가 끝난 뒤 성공이나 실패 메시지를 보여 주지 않습니다. 문서는 최근 10분 동안의 전달 로그를 보여 주는 Terminal 명령을 안내하며, 여기서 명령이 성공했는지, 실패했는지, 10초를 넘겼는지 알 수 있습니다.

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

문서는 이 로그에 받아쓴 텍스트가 들어 있을 수 있다고 경고합니다. 또 명령이 텍스트를 웹 서비스로 보낸다면 그 서비스가 텍스트를 받습니다. VoiceInk는 설정한 것만 실행합니다.

YapToText의 위치

VoiceInk는 문서에서 2026년 10월 10일에 읽은 내용이고, YapToText는 앱 자체의 설정에서 가져왔습니다.

VoiceInkYapToText
텍스트로 셸 명령 실행가능, Custom Command 출력불가능
커서 위치에 붙여넣기Paste 출력Paste, 기본값
붙여넣는 대신 입력하기이 페이지에는 설명이 없습니다Type character by character
클립보드에만 복사pbcopy 같은 명령으로 가능Copy to clipboard only
끝난 뒤 키 누르기Paste and Press Tab 템플릿앱마다 Return 또는 Command Return
들어가기 전에 확인이 페이지에는 설명이 없습니다Review before inserting, 기본값은 꺼짐

받아쓰기로 자신의 스크립트를 움직이고 싶다면, VoiceInk의 Custom Command는 YapToText에 없는 일을 합니다. 커서 위치에, 주변 단어에 맞춰 다듬어진 텍스트를 원한다면 YapToText가 기본으로 그렇게 하고 스크립트가 필요 없습니다. VoiceInk Modes 페이지에서는 출력 모드를 설정하는 곳을 다루고, VoiceInk와 superwhisper 비교에서는 모드를 중심으로 만들어진 다른 앱과 비교합니다.

Mac App Store에서 YapToText 다운로드무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.

정리

  • 정체. 최종 텍스트로 셸 명령을 실행하는 출력 모드입니다.
  • 텍스트. 표준 입력과 $VOICEINK_TRANSCRIPT로 전달됩니다.
  • 제한. 10초이고, 입력은 받을 수 없으며, 자동 붙여넣기는 없고, 실시간 받아쓰기에서만 작동합니다.
  • 문제 확인. 앱에는 메시지가 나오지 않습니다. 위의 Terminal 명령으로 로그를 읽으세요.
  • 시작하는 방법. 다섯 가지 템플릿 중 하나를 고쳐 쓰세요.

VoiceInk가 Custom Command의 작동 방식을 바꾸면 GitHub에 이슈를 남겨 주세요. 이 페이지를 고치겠습니다. 모두 읽습니다.

Mac App Store에서 YapToText 다운로드무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.

글쓴이 소개. Ryleigh Newman은 소프트웨어를 개발합니다. 손으로 타이핑하기가 어려워서, 이 사이트에서 소개하는 앱인 YapToText로 매일 받아쓰기를 합니다. 이 페이지는 영어에서 번역한 것입니다. 앱의 화면과 사이트의 다른 페이지는 영어로 되어 있습니다. 프로젝트 더 알아보기(영어).

가이드

다른 가이드(영어)

출처

자주 묻는 질문

VoiceInk의 Custom Command는 무엇인가요?

출력 모드입니다. 붙여넣는 대신 VoiceInk가 직접 작성한 셸 명령을 실행하고, 받아쓰기의 최종 텍스트를 넘겨 줍니다.

VoiceInk Custom Command는 텍스트를 어떻게 받나요?

UTF-8로 표준 입력과 변수 $VOICEINK_TRANSCRIPT에 담겨 옵니다. 공백과 줄바꿈이 유지되도록 변수를 따옴표로 감싸세요.

VoiceInk Custom Command가 아무것도 붙여넣지 않는 이유는 무엇인가요?

Custom Command 출력은 스스로 붙여넣지 않습니다. Paste and Press Tab 템플릿처럼 명령이 직접 텍스트를 복사하거나 붙여넣어야 합니다.

VoiceInk Custom Command는 얼마 동안 실행될 수 있나요?

10초입니다. 그 뒤에는 VoiceInk가 중단합니다. 더 오래 걸리는 작업은 백그라운드 프로세스를 시작하세요.

YapToText에도 VoiceInk 같은 custom command가 있나요?

받아쓰기 뒤에 셸 명령을 실행하지 않습니다. 커서 위치에 붙여넣거나 입력하고, 클립보드에만 복사할 수 있으며, 텍스트가 들어간 뒤 Return을 누를 수 있습니다.