繁體中文 English

VNC Pad Helper 安裝教學

適用於 macOS | 版本 1.1
什麼是 Helper？
VNC Pad Helper 是一個選用的 macOS Menu Bar 輔助工具。安裝後，您可以在遠端桌面中使用注音、拼音、日文等非英文輸入法。不安裝 Helper 也能正常使用 VNC Pad，只是無法使用輸入法。

為什麼需要 Helper？

VNC 協定只能傳送英文按鍵訊號，無法觸發 macOS 的輸入法系統（如注音、拼音）。Helper 透過在 macOS 端直接注入鍵盤事件，讓輸入法能正常運作。

運作架構：

系統需求

安裝步驟

1 下載 Helper

下載 VNCRemoteHelper-1.1.dmg

已通過 Apple Notarization 認證，可安心安裝。

2 安裝到應用程式

打開下載的 DMG 檔案，將 VNCRemoteHelper 拖曳到「Applications」資料夾。

3 啟動 Helper

從「應用程式」資料夾或 Spotlight 搜尋開啟 VNCRemoteHelper。

啟動後，螢幕右上角的 Menu Bar 會出現鍵盤圖示（⌨）。點擊圖示即可看到：

  • 運行狀態
  • PIN 碼（iPad 連線時需要輸入）
  • 連線中的裝置

4 授予 Accessibility 權限

macOS 會提示需要「輔助使用」權限：

  1. 打開「系統設定」→「隱私權與安全性」→「輔助使用」
  2. 找到 VNCRemoteHelper
  3. 啟用權限
  4. 重新啟動 Helper（授權後需要重啟才會生效）

使用方式

在 Mac 上

  1. 確保「系統設定」→「共享」→「螢幕共享」已啟用
  2. 確認 Menu Bar 有鍵盤圖示（⌨），表示 Helper 正在執行
  3. 點擊圖示確認 PIN 碼

在 iPad 上

  1. 連接外接鍵盤（藍牙或有線）
  2. 開啟 VNC Pad App → 連線到 Mac
  3. 連線成功後，App 會自動嘗試連接 Helper
  4. 輸入 Mac 上顯示的 PIN 碼

測試輸入法

  1. 在遠端 Mac 上打開任一文字編輯器（TextEdit、備忘錄等）
  2. 按 Control + Space 切換到注音（或其他輸入法）
  3. 用 iPad 外接鍵盤輸入，例如：ㄉㄚˋ
  4. 應該會看到選字候選清單

開機自動啟動（建議）

  1. 打開「系統設定」→「一般」→「登入項目」
  2. 點擊「+」加入 VNCRemoteHelper.app
  3. 之後開機就會自動啟動，常駐在 Menu Bar

常見問題

Helper 啟動失敗

可能是 port 50001 被佔用。檢查方法：

lsof -i :50001

如果有其他程式佔用，先關閉該程式再重試。

iPad 無法連接 Helper

連上了但輸入法不工作

不安裝 Helper 可以嗎？

可以。不安裝 Helper 的話，VNC Pad 的所有功能都正常運作，只是無法使用中文、日文等輸入法。英文輸入和所有快捷鍵不受影響。

聯絡我們

如有問題或建議：

VNC Pad Helper Setup Guide

For macOS | Version 1.1
What is Helper?
VNC Pad Helper is an optional macOS Menu Bar companion tool. Once installed, you can use Chinese (Zhuyin/Pinyin), Japanese, Korean, and other non-English input methods on the remote desktop. VNC Pad works fine without Helper — you just won't be able to use input methods.

Why Do I Need Helper?

The VNC protocol can only send English key signals and cannot trigger macOS input method systems (e.g., Zhuyin, Pinyin). Helper works by injecting keyboard events directly on the macOS side, allowing input methods to function properly.

Architecture:

System Requirements

Installation

1 Download Helper

Download VNCRemoteHelper-1.1.dmg

Notarized by Apple for safe installation.

2 Install to Applications

Open the downloaded DMG file and drag VNCRemoteHelper into the Applications folder.

3 Launch Helper

Open VNCRemoteHelper from the Applications folder or via Spotlight.

Once launched, a keyboard icon (⌨) will appear in the Menu Bar (top-right). Click the icon to see:

  • Running status
  • PIN code (needed when connecting from iPad)
  • Connected devices

4 Grant Accessibility Permission

macOS will prompt for Accessibility access:

  1. Open System Settings → Privacy & Security → Accessibility
  2. Find VNCRemoteHelper
  3. Enable the toggle
  4. Restart Helper (required after granting permission)

Usage

On Your Mac

  1. Ensure Screen Sharing is enabled (System Settings → Sharing)
  2. Confirm the keyboard icon (⌨) is visible in the Menu Bar
  3. Click the icon to check the PIN code

On Your iPad

  1. Connect an external keyboard (Bluetooth or wired)
  2. Open VNC Pad App → Connect to your Mac
  3. After connecting, the app will automatically attempt to connect to Helper
  4. Enter the PIN code shown on your Mac

Test Input Methods

  1. Open any text editor on the remote Mac (TextEdit, Notes, etc.)
  2. Press Control + Space to switch input methods
  3. Type using your iPad external keyboard
  4. You should see the input method candidate list appear

Auto-Start on Login (Recommended)

  1. Open System Settings → General → Login Items
  2. Click "+" and add VNCRemoteHelper.app
  3. Helper will automatically start and stay in the Menu Bar on every login

Troubleshooting

Helper Fails to Start

Port 50001 may be in use. Check with:

lsof -i :50001

If another process is using the port, close it and try again.

iPad Can't Connect to Helper

Connected but Input Methods Don't Work

Do I Need Helper?

No. Without Helper, all VNC Pad features work normally — you just can't use Chinese, Japanese, or other non-English input methods. English input and all keyboard shortcuts work fine without it.

Contact Us

Questions or suggestions: