下載 YapToText 到你的 Mac

作者 · 發佈於 · 更新於

從 Mac App Store 安裝 YapToText。它是免費的，兩個模型都內附在 App 裡，所以第一次開啟就算關掉 Wi-Fi 也能聽寫。如果你比較想用 Terminal，一行 Homebrew 指令可以安裝同一個 App，只是不含模型，第一次聽寫之前要先下載一個語音模型。

不管用哪一種方式，你都需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本，還有兩項權限：麥克風，讓 App 聽得到你說話，以及輔助使用，讓它能在其他 App 裡輸入文字。

在 Mac App Store 下載 YapToText免費下載。不需要帳號，沒有鎖住的功能。需要搭載 Apple 晶片的 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, 简体中文

步驟

  1. 從 Mac App Store 安裝 YapToText，或在 <span lang="en">Terminal</span> 執行 brew install --cask ryleighnewman/yaptotext/yaptotext。
  2. 如果你用的是 Homebrew，請打開 <span lang="en">AI Models</span> 頁面，下載 Whisper Large v3 Turbo (Q5)，想用會整理文字的模式的話，再加上 Phi-3.5 Mini Instruct。
  3. 打開 YapToText，macOS 詢問時允許使用麥克風。
  4. 在 Home 頁面按 <span lang="en">Accessibility</span> 旁邊的 <span lang="en">Grant</span>，然後在「系統設定」，「隱私權與安全性」，「輔助使用」裡把 YapToText 打開。
  5. 點一下想讓文字出現的位置，按一下 <span lang="en">Right Command</span>，說話，再按一次 <span lang="en">Right Command</span>。

確認你的 Mac 能不能執行

YapToText 有三項需求。你需要搭載 Apple 晶片的 Mac、macOS 14 或以上版本，以及給 App Store 版本用的約 2.9 GB 空間。

  • 搭載 Apple 晶片的 Mac。我沒有在 Intel Mac 上測試過任何東西，所以不支援。
  • macOS 14 (Sonoma) 或以上版本。Homebrew cask 不會安裝在更舊的版本上。在 macOS 26 上，介面會套用 Liquid Glass 的外觀。
  • 麥克風。Mac 內建的麥克風就可以，而且它收你的聲音比藍牙耳機清楚，因為藍牙耳機傳送的是電話等級的音質。

App Store 版本約需要 2.9 GB 空間，大部分是兩個模型。Homebrew 版本下載約 12 MB，解壓縮後約 18 MB，另外還要加上你自己下載的模型。沒有 iPhone、iPad、Windows 或 Linux 版本。

從 Mac App Store 安裝

我推薦 Mac App Store 版本，因為不需要再設定任何東西。它不用花錢，沒有付費方案，也不用建立帳號。價格頁面說明了這裡的免費是什麼意思。App 裡唯一會收錢的地方是一個可以不理會的小費罐，沒有任何功能被它鎖住。兩個模型都內附在 App Store 版本裡，所以沒有其他東西需要下載。

  • 操作：打開 Mac App Store 上的 YapToText 並下載。
  • macOS：下載約 2.9 GB，大部分是兩個模型：負責語音的 Whisper Large v3 Turbo (Q5)，574 MB，以及負責整理文字的 Phi-3.5 Mini Instruct，顯示為 2.3 GB。
  • 確認：YapToText 在你的 Applications 資料夾裡，打開之後，水豚會出現在你的選單列。

更新和其他 App 一樣，透過 App Store 取得。YapToText 自己不會連到伺服器檢查更新。

App Store 海報，標題為 Yap it. Bam. It's typed.，畫面上有 YapToText 的 Home 視窗和三種浮動面板版面。
圖1. 其中一張 App Store 海報，讓你看到上架頁面時認得出來：Home 視窗，加上三種版面的浮動面板。

或用 Homebrew 安裝

Homebrew 從同一個來源安裝同一個 App，有三個差別。它是用 Developer ID 簽署並經過公證，而不是 App Store 簽署，不含模型，而且版本可能比 App Store 版本落後一版。更新內容頁面列出了兩者。先安裝，然後在第一次聽寫之前下載一個語音模型。

Terminal：從我的 Homebrew tap 安裝 YapToText。

brew install --cask ryleighnewman/yaptotext/yaptotext

會發生什麼：下載約 12 MB 之後，YapToText 會出現在你的 Applications 資料夾裡，Homebrew 也會印出一則提示，要你打開 AI Models 並下載一個語音模型。安裝其中一個之前，App 無法聽寫。

YapToText 的 AI Models 頁面：Whisper Large v3 Turbo (Q5) 和 Phi-3.5 Mini Instruct 都標示為 Included，下方是模型庫。
圖2. AI Models 頁面。在 App Store 版本上，兩個預設模型都顯示 Included，就像這裡一樣。在 Homebrew 版本上，請先在這個頁面下載一個語音模型。
  • 操作：打開 YapToText，前往 AI Models 頁面，下載 Whisper Large v3 Turbo (Q5)，574 MB。如果想用 Auto mode、Quick Edit 或任何其他會整理文字的模式，再加上 Phi-3.5 Mini Instruct，2.3 GB。
  • YapToText：透過 HTTPS 從 Hugging Face 取得檔案，存放在它自己的容器裡，更新時這些檔案不會消失。這個下載是 App 唯一會自己發起的網路流量，而且只有在你按下去的時候才會發生。
  • 確認：模型顯示為已安裝，試著聽寫一次就會輸入文字。在那之前，聽寫會回報沒有安裝語音模型。

Raw Transcription 只需要語音模型。其他每一種內建模式、Auto mode 的格式整理和 Quick Edit 還會用到整理模型。AI Models 說明頁面說明模型庫裡的每一個模型。

還有兩件事要知道。這個 cask 會把 YapToText 安裝到 /Applications，所以如果那裡已經有 App Store 的副本，就會被取代：請選一種安裝方式。另外，模型不放進這個版本的原因很單純：加上模型的話，App 會超過 GitHub 對發佈檔案 2 GB 的限制，不含模型的話，解壓縮後只有約 18 MB。

授予兩項權限

第一次開啟時會帶你設定這兩項權限，之後隨時可以在 Home 頁面的 Get set up 卡片再看到它們。麥克風是必要的。輔助使用則讓 YapToText 能在其他 App 裡輸入文字。沒有它的話，每次聽寫仍然會轉寫，只是改為拷貝到你的剪貼板。

步驟 1：讓它聽到你

  • 操作：在 Get set up 卡片裡，按一下 Microphone 旁邊的 Continue，或直接開始你的第一次聽寫。
  • macOS：只會詢問一次是否允許 YapToText 使用麥克風。請選擇允許。
  • 確認：Microphone 那一列出現綠色勾號。如果你不小心拒絕了，請到「系統設定」，「隱私權與安全性」，「麥克風」，把 YapToText 打開。

步驟 2：讓它替你輸入

  • 操作：按一下同一張卡片裡 Accessibility 旁邊的 Grant。
  • macOS：打開「系統設定」，「隱私權與安全性」，「輔助使用」。App 無法自己把這項設定打開，所以要由你把 YapToText 旁邊的開關打開。
  • 確認：幾秒鐘之內，Get set up 卡片就會從 Home 頁面消失，因為兩項權限都已經開啟。如果開關一直無法保持開啟，按 Show in Finder，把 App 拖進列表，再按 Recheck。
YapToText 的 Home 頁面：Start Dictation 按鈕、有 Right Command 和 Right Option 的 Keys 卡片，以及 Intelligent Insert。
圖3. 兩項權限都開啟之後的 Home 頁面：Get set up 卡片不見了，Start Dictation 就在歡迎訊息的正下方。

輔助使用也是 Right Command 鍵和讀取你所選文字的基礎。備用快速鍵 Control Option Space 不需要它也能用。

做第一次聽寫

第一次聽寫只要把一個鍵按兩次。點一下想讓文字出現的位置，按一下 Right Command，說話，再按一下。文字會出現在游標原本的位置。說話的時候，Space 暫停，Esc 取消，數字鍵選擇模式。

第一次聽寫指南有逐步的版本，也說明每一步會看到什麼，按鍵與快速鍵頁面則說明怎麼改成按住說話，或換成別的鍵。

YapToText 在 Mac 上的浮動聽寫面板：即時波形、正在輸入的句子，以及取消、暫停和停止按鈕。
圖4. 按一下 Right Command 時出現的浮動面板：你的聲音變成波形，你說的話逐漸成形，下方是模式標籤。

如果什麼都沒有輸入

  1. 先點進 App 裡。YapToText 不會輸入到它自己的視窗，所以在它位於最前面時開始的聽寫會進到剪貼板。按 Command V 貼上。
  2. 打開輔助使用。在「系統設定」，「隱私權與安全性」，「輔助使用」裡，把 YapToText 打開。沒有它的話，每次聽寫都會拷貝到剪貼板，而不是輸入，Right Command 也不會有任何作用。
  3. 下載語音模型。在 Homebrew 版本上，要先在 AI Models 頁面安裝 Whisper Large v3 Turbo (Q5) 或其他語音模型，才能轉寫任何東西。
  4. 檢查麥克風。如果面板說沒有聽到，表示 App 收到的是靜音。請在 Settings, General, Microphone 選擇你的麥克風，說話時看著即時音量表。

疑難排解頁面說得更深入，說明索引則列出每一份指南。如果是 Apple 自己的聽寫給你帶來麻煩，請改從 Mac 聽寫沒反應開始。

更新、移除，或自己編譯

App Store 版本透過 Mac App Store 更新。Homebrew 版本用一行指令更新。

Terminal：把 Homebrew 版本更新到我的 tap 裡最新的版本。

brew upgrade --cask yaptotext

會發生什麼：Homebrew 把 App 換成最新的 cask 版本。你的設定、歷史記錄和下載的模型都會保留，因為它們存放在 App 自己的容器裡。

第一個 Homebrew 版本 1.3.1 無法使用麥克風。1.4 修好了，所以如果你很早就安裝了，請升級。

要把 Homebrew 版本連同它儲存的內容一起移除，請使用 zap 選項。

Terminal：解除安裝 YapToText 和它的資料。

brew uninstall --zap --cask yaptotext

會發生什麼：Homebrew 移除 App，並把它的容器和支援資料夾移到 Trash，你的設定、歷史記錄、儲存的音訊和下載的模型也會一起被帶走。

如果是 App Store 版本，在 Settings, Advanced 裡按 Erase All Data，會刪除你的設定、模式、字典、指令、AI 動作、歷史記錄和儲存的音訊，然後回到歡迎畫面重新啟動。之後再把 App 移到 Trash。

自己從原始碼編譯

整個 App 都在 GitHub 上，採用 GPL-3.0 授權。你需要 Xcode 26 或以上版本。複製專案，打開 YapToText.xcodeproj，選擇 YapToText scheme，按 Command R。它是沙盒化的，編譯出來的和上架的一樣。GitHub 上的原始碼可能比 App Store 版本落後一版。更新內容列出了兩者。

重點整理

  • 大多數人。從 Mac App Store 安裝。兩個模型都在裡面，所以第一次開啟就可以離線使用。
  • Homebrew 使用者。執行那一行指令，然後在聽寫之前，先到 AI Models 頁面下載 Whisper Large v3 Turbo (Q5)。
  • 每個人。授予麥克風和輔助使用，點一下想讓文字出現的位置，然後按兩次 Right Command。
  • 價格。免費。價格頁面說明了免費是什麼意思。
  • 還在選。比較頁面把它和其他 Mac 聽寫 App 放在一起看。

安裝，授予兩項權限，按一下 Right Command，說話。如果這裡有哪一點和你看到的不一樣，請在 GitHub 上告訴我。每一則我都會看。

在 Mac App Store 下載 YapToText免費下載。不需要帳號，沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。

關於作者。 Ryleigh Newman 從事軟體開發，用手打字有困難，每天都用本站介紹的 YapToText 聽寫。本頁譯自英文。App 的介面和網站的其他頁面是英文的。 進一步瞭解這個專案（英文）。

指南

更多指南（英文）

資料來源

常見問題

Homebrew 版本的 YapToText 和 App Store 版本一樣嗎？

幾乎一樣。它們是用同一個來源編譯的，但 Homebrew 版本是用 Developer ID 簽署並經過公證，不含語音模型和整理模型，而且版本可能比 App Store 版本落後一版。

用 Homebrew 安裝 YapToText 之後，該下載哪個模型？

Whisper Large v3 Turbo (Q5)，這是推薦的語音模型，574 MB。Raw Transcription 只需要它。如果想用 Auto mode、Quick Edit 和其他會整理文字的模式，再加上約 2.3 GB 的 Phi-3.5 Mini Instruct。

YapToText 需要網路連線嗎？

不需要，App Store 版本不用。兩個模型都在 App 裡，所以第一次開啟就能離線使用。Homebrew 版本需要連線一次，用於你自己開始的模型下載。

App Store 版本和 Homebrew 版本可以同時安裝嗎？

不行。Homebrew cask 會把 YapToText 安裝到 /Applications，並取代已經在那裡的 App Store 副本。請選一種安裝方式。

怎麼更新 YapToText？

App Store 版本透過 Mac App Store 更新。Homebrew 版本用 brew upgrade --cask yaptotext 更新。App 自己不會檢查更新。