在 OBS 用 Zoom-to-Mouse 聚焦游標：一則安裝筆記

錄製程式教學時，游標常常知道自己正在指哪裡，但觀眾不一定看得清楚。OBS Zoom-to-Mouse 是一支 Lua script，能在 OBS Studio 裡讓指定的 Display Capture 來源以游標位置為焦點縮放，再用熱鍵切回原本畫面。這篇只保留一條可重現的安裝路徑，並把相容性限制說清楚；它是一則 focused Note，不是完整的 OBS 錄影教學。

這支腳本改變的是哪個畫面？

腳本不是在作業系統桌面上放大滑鼠，也不是替影片後製加上特效。它會讀取 OBS 場景中的顯示擷取來源，利用 crop/pan 的方式改變可見區域，讓游標附近看起來被放大。上游 README 也提醒，顯示器排列、裁切、縮放比例或非 Display Capture 來源不符合預期時，腳本可能需要手動提供來源位置與尺寸。

安裝和啟用只需要三個位置

1. 從 OBS Zoom-to-Mouse 的原作者 repository 下載 obs-zoom-to-mouse.lua。
2. 在 OBS 中打開 Tools → Scripts，按 + 載入 Lua script。
3. 在 File → Settings → Hotkeys 為 Toggle zoom to mouse 綁定快捷鍵；若要獨立控制游標跟隨，再設定 Toggle follow mouse during zoom。

載入後，先在腳本設定選擇要縮放的 Display Capture，再錄一小段測試影片。按一次熱鍵應該以目前游標位置作為放大焦點；再按一次還原。若啟用自動跟隨，游標接近放大區域邊界時，畫面才會繼續移動。

最容易踩到的限制

上游 README 的基準是以 OBS 29.1.3 建立，並說明腳本可在 Windows、Linux 與 macOS 使用；論壇資源頁也記錄過跨平台更新。這些資料不足以替目前或未來所有 OBS 版本背書，更新 OBS 或 script 後應重新錄製短測試。

特別注意三件事：

• 自動計算主要針對 Display Capture。選擇 Window Capture、Browser Source 或其他來源時，可能必須開啟 Show all sources 並手動填寫來源位置、尺寸和縮放比例。
• 如果改了多螢幕位置、主螢幕、方向或裁切設定，腳本保存的幾何資訊可能失效；重新加入 Display Capture 並 reload script 是上游建議的排查方向。
• Zoom Factor、Zoom Speed、Follow Speed 和 safe-zone 相關選項是觀感調整，不是越大越好。放大倍數太高會讓程式碼離開畫面，跟隨太敏感則會讓讀者難以閱讀。

小結

如果你的問題是「如何在錄製教學時快速聚焦游標」，這支 Lua script 是一個輕量解法：一個 script、OBS 內建的 Scripts 面板、以及一個熱鍵就能開始測試。它的邊界也很明確：它依賴 OBS 的來源幾何與腳本 API，不會替你處理所有來源類型、跨螢幕校正或版本相容性。

本文的截圖與影片示範是原始文章留下的使用紀錄。要取得目前版本、更新說明與完整參數，請以 上游 README 和 OBS resource page 為準。