VoiceInk Custom Commands: שולחים את ההכתבה לסקריפט במקום להדביק אותה

מאת · פורסם

Custom Command (פקודה מותאמת) הוא אחד ממצבי הפלט של VoiceInk. במקום להדביק, VoiceInk מעבירה את המלל המוגמר של ההכתבה לפקודת shell שכותבים, והפקודה קובעת מה קורה: להוסיף אותו להערה, לפתוח חיפוש, להריץ סקריפט משלך או לשלוח אותו לשירות שמפעילים. זה הדבר הגמיש ביותר שאפשר לעשות ב-VoiceInk עם מלל, ויש לו כמה מגבלות קשיחות שכדאי להכיר לפני שבונים עליו.

פיתחתי את YapToText, אפליקציית הכתבה אחרת ל-Mac, ולכן כדאי לקרוא את דבריי על VoiceInk מתוך מודעות לכך. כל עובדה על VoiceInk כאן לקוחה מהתיעוד שלה עצמה, שנקרא ב-10 באוקטובר 2026.

הורדת YapToText מה-Mac App Storeההורדה בחינם. בלי חשבון ובלי מאפיינים נעולים, ל-macOS 14 ומעלה ב-Mac עם שבב Apple. קוד המקור ב-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 שולחת את אותו מלל סופי בשתי דרכים: בקלט הסטנדרטי (standard input) ובמשתנה $VOICEINK_TRANSCRIPT. המלל הוא ב-UTF-8, והתיעוד מבקש לשים את המשתנה במרכאות כדי שרווחים, סימני פיסוק וירידות שורה יישמרו.

  • כש-AI Enhancement (שיפור בעזרת בינה מלאכותית) כבוי. התמלול אחרי העיצוב וההחלפות של VoiceInk נשלח כמות שהוא.
  • כש-AI Enhancement פועל ועובד. המלל המשופר הוא שנשלח.
  • כש-AI Enhancement דולג או נכשל. התמלול הסופי הפשוט הוא שנשלח.

הפקודה אף פעם לא מקבלת ישירות את השמע, את הפרומפט, או את המלל הנבחר, מהלוח או מהמסך. אם רוצים שההקשר יעצב את התוצאה, התיעוד אומר להשתמש בפרומפט וב-Context Awareness (מודעות להקשר), כך שהוא כבר נמצא במלל הסופי.

איך זה רץ

מתוך התיעוד של VoiceInk, Custom Commands, שנקרא ב-10 באוקטובר 2026.

פרטהתנהגות
ה-shell/bin/zsh -lc
מגבלת זמן10 שניות, ואז VoiceInk עוצרת את הפקודה
הרשאותאותן הרשאות של משתמש ב-macOS כמו של VoiceInk
המקליטנסגר לפני שהפקודה מתחילה
הצלחהקוד יציאה 0. כל דבר אחר נחשב לכישלון
פלטהפלט הסטנדרטי והשגיאות נשמרים לצורכי אבחון, ואף פעם לא מודבקים באפליקציה
פקודות שלא נמצאוVoiceInk מנסה את ה-PATH של ה-shell שלך. אם זה נכשל, משתמשים בנתיב מלא, כמו /opt/homebrew/bin/tool

המגבלות שמפתיעות

  • שום דבר לא מודבק מעצמו. אם עדיין רוצים את המלל באפליקציה, הפקודה צריכה להעתיק או להדביק אותו בעצמה.
  • עשר שניות, בלי שאלות. הפקודה אינה יכולה להמתין לקלט. לעבודה ארוכה יותר, מפעילים תהליך רקע נפרד ויוצאים במהירות.
  • זה לא משנה את התמלול השמור. מה שהפקודה מדפיסה אינו נכתב בחזרה.
  • אין Auto Send. האפשרות Auto Send (שליחה אוטומטית) פועלת רק עם Paste output, לא עם Custom Command.
  • רק הכתבה חיה. קבצים בתור של Transcribe file (תמלול קובץ) נשמרים בלי להריץ פקודות פלט.
  • בלי פקודה ריקה. אי אפשר לשמור Mode (מצב) עם פקודה ריקה.

התבניות המובנות

מתוך התיעוד של VoiceInk, Custom Commands, שנקרא ב-10 באוקטובר 2026.

תבניתמה היא עושה
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. התיעוד נותן פקודת Terminal שמציגה את יומני המסירה של 10 הדקות האחרונות, כולל אם הפקודה הצליחה, נכשלה או חרגה מ-10 שניות:

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

התיעוד מזהיר שהיומנים האלה עשויים להכיל מלל שהוכתב. ואם הפקודה שולחת מלל לשירות אינטרנט, השירות מקבל אותו: VoiceInk רק מריצה את מה שהוגדר.

איפה YapToText עומדת

VoiceInk לפי התיעוד שלה, שנקרא ב-10 באוקטובר 2026. YapToText לפי ההגדרות שלה.

VoiceInkYapToText
הרצת פקודת shell עם המללכן, פלט Custom Commandלא
הדבקה בסמןPaste outputPaste, ברירת המחדל
להקליד במקוםלא מתואר בעמוד הזהType character by character
ללוח בלבדעם פקודה כמו pbcopyCopy to clipboard only
לחיצה על מקש אחריהתבנית Paste and Press TabReturn או Command Return לכל אפליקציה
סקירה לפני שהמלל נוחתלא מתואר בעמוד הזהReview before inserting, כבוי כברירת מחדל

מי שרוצה שההכתבה תפעיל סקריפטים משלה ימצא ב-Custom Command של VoiceInk יכולת ש-YapToText אין לה. מי שרוצה מלל בסמן, מותאם למילים שסביבו, ימצא ש-YapToText עושה זאת כברירת מחדל, בלי סקריפט. הדף על מצבי VoiceInk מסביר איפה מגדירים מצבי פלט, וVoiceInk מול superwhisper משווה אותה לאפליקציה אחרת שבנויה סביב מצבים.

הורדת YapToText מה-Mac App Storeההורדה בחינם. בלי חשבון ובלי מאפיינים נעולים, ל-macOS 14 ומעלה ב-Mac עם שבב Apple. קוד המקור ב-GitHub.

בקצרה

  • מה זה. זהו מצב פלט שמריץ פקודת shell עם המלל הסופי.
  • המלל. הוא מגיע בקלט הסטנדרטי ובמשתנה $VOICEINK_TRANSCRIPT.
  • מגבלות. המגבלות הן 10 שניות, בלי קלט, בלי הדבקה אוטומטית והכתבה חיה בלבד.
  • איתור תקלות. אין הודעה באפליקציה, ולכן קוראים את היומן בעזרת פקודת ה-Terminal שלמעלה.
  • איפה מתחילים. עורכים אחת מחמש התבניות.

אם VoiceInk משנה את אופן הפעולה של Custom Commands, אפשר לפתוח issue ב-GitHub ואעדכן את העמוד. כל פנייה נקראת.

הורדת YapToText מה-Mac App Storeההורדה בחינם. בלי חשבון ובלי מאפיינים נעולים, ל-macOS 14 ומעלה ב-Mac עם שבב Apple. קוד המקור ב-GitHub.

מי כותב כאן. שמי Ryleigh Newman. פיתוח תוכנה הוא העיסוק שלי, קשה לי להקליד, ובכל יום ההכתבה שלי נעשית ב-YapToText, האפליקציה שהאתר הזה מתאר. העמוד הזה תורגם מאנגלית. הממשק של האפליקציה ושאר עמודי האתר הם באנגלית. עוד על הפרויקט, באנגלית.

מדריכים

מדריכים נוספים, באנגלית

מקורות

שאלות

מה זה Custom Command ב-VoiceInk?

מצב פלט. במקום להדביק, VoiceInk מריצה פקודת shell שכותבים ומעבירה לה את המלל הסופי של ההכתבה.

איך Custom Command ב-VoiceInk מקבל את המלל?

בקלט הסטנדרטי ובמשתנה $VOICEINK_TRANSCRIPT, ב-UTF-8. שמים את המשתנה במרכאות כדי לשמור על רווחים וירידות שורה.

למה Custom Command ב-VoiceInk לא מדביק כלום?

הפלט Custom Command אינו מדביק מעצמו. הפקודה צריכה להעתיק או להדביק את המלל בעצמה, כמו שעושה התבנית Paste and Press Tab.

כמה זמן Custom Command ב-VoiceInk יכול לרוץ?

10 שניות. אחרי זה VoiceInk עוצרת אותו. לעבודה ארוכה יותר מפעילים תהליך רקע.

האם ל-YapToText יש פקודות מותאמות כמו ב-VoiceInk?

היא אינה מריצה פקודות shell אחרי הכתבה. היא מדביקה או מקלידה בסמן, יכולה להעתיק ללוח בלבד, ויכולה ללחוץ על Return אחרי שהמלל נוחת.