CueT 使用手冊

CueT 是一款專為現場演出打造的字幕軟體，旨在將繁瑣的字幕編排流程變得簡單且快速。透過直覺的操作介面，您可以高效地管理字幕、樣式與特效，大幅提升工作效率並確保演出的穩定播出。

特色

1. 快速建立：直接貼入劇本文字即可自動拆分為字幕，省去手動建立分頁的繁瑣。
2. 高效管理：支援樣式群組化，讓您可以一次性調整所有同類型字幕的觀感。
3. 專業連動：支援 OSC 協定，可無縫接收 QLab 等外部控台的觸發指令。
4. 內建特效：整合動態渲染粒子系統，輕鬆實現雪、雨、星空及煙霧等效果。
5. 次字幕支援：具備靈活的雙層架構，可對應備註或輔助內容，並獨立自訂樣式。
6. SRT 匯出：自動記錄演出的精準時戳，隨時匯出 SRT 檔案，大幅簡化後期流程。

核心概念

在開始使用之前，讓我們先瞭解 CueT 的構成元素：

• 字幕（Subtitle）：演出的靈魂，包含一般文字、多行句群（Block）與空畫面。
• 佈景（Scenery）：畫面的妝點，包含圖片、單色塊與內建動態特效。

CueT 的畫面由三層排列而成：

1. 前景層：顯示於最上方，放置在此層的佈景會遮擋住字幕。
2. 字幕層：核心內容區，所有字幕皆在此層呈現。
3. 背景層：顯示於最下方，適合放置背景圖或氛圍特效。

字幕編排

快速建立字幕

開啟新專案後，您只需在 輸入字幕內容 區塊直接貼入文字，系統就會自動將每一行拆分為獨立的字幕。

善用樣式分組

樣式分組能讓您批次管理字幕的觀感，修改設定後會立即套用到所有隸屬該分組的字幕，無需逐一調整。

在「新建專案」時設定

在貼入文字時，若想將特定句子歸類，只需在行首加上 # （井字號後加一個半形空格）：

• 使用一個 # 、兩個 ## 或三個 ### 代表不同的樣式等級。
• 未標記的句子將自動歸類為 basic 基本樣式。

範例：

# 這是主標題 (Style 1)
## 這是副標題 (Style 2)
這是內文 (Basic)

在「編輯專案」時調整

您可以在字幕編輯介面隨時替換該句所屬的「樣式」，或切換至樣式分組面板新增更多分組。

建立句群 (Block)

若您希望多行文字（如詩詞）同時出現在一個畫面中，可以使用「句群」功能。

在「新建專案」時設定

在欲合併的句子行首輸入 -- （兩個減號後加一個半形空格），CueT 就會將它們聯繫在一起。 若要為整個句群指定樣式，請在句首的 -- 後方接著組合 # 標籤。

範例：

-- ## 文字一
-- 文字二
-- 文字三

此句群將會套用 ## 的樣式。

在「編輯專案」時操作

1. 在左側字幕列表，按住 Cmd (Mac) 或 Ctrl (Win) 可選取多個不連續字幕。
2. 或按住 Shift 選取範圍內的字幕。
3. 點擊右鍵選擇 群組化 即可完成合併。

插入空畫面

空畫面常用於轉場或特定時刻，用來清除畫面上所有的字幕。

在「新建專案」時設定

在文字中單獨輸入一行 @@@，系統就會將其解析為空畫面。

在「編輯專案」時操作

在列表中的任一字幕點選右鍵，選擇 增加空畫面，即可在該位置後方插入。

加入次字幕（翻譯）

次字幕通常作為翻譯用途。點選上方工具列右側選單，即可開啟 加入次字幕 面板。

• 輸入：直接貼入翻譯文字，每行文字會自動與主字幕一一對應。
• 匯入 CSV：您可以下載 CSV 範本，在 Excel 或 Numbers 中編輯完成後再匯入。

!TIP 選擇輸入時，建議先下載「主字幕 TXT 檔案」作為翻譯時的參照，能更精準地對應每一句台詞。

樣式設計

樣式繼承規則

CueT 採用靈活的三層樣式架構，由高至低優先權如下：

1. 字幕自訂：針對單一字幕點進行的特殊設定。
2. 群組樣式：針對特定樣式分組（如 # 或 ##）的設定。
3. 全域樣式：整個專案的基礎設定。

!NOTE 系統會由上而下尋找設定值。若單句未自訂樣式，則會自動回退（Fallback）使用群組樣式，若仍未設定，則使用全域樣式。

最長句預覽

為了避免演出時文字意外折行，您可以使用「最長句」功能。系統會抓取分組內最長的句子作為範例，協助您設定合適的字體大小。

句群進場設定

您可以決定句群的展現方式：

• 顯示模式：設定句群的顯示方式。
  • 逐行 (Step)：按一下進場一行，直到全數顯示。
  • 全顯 (All)：按一下句群內的所有文字同時顯示。
• 行距 (Gap)：調整句群內每句字幕間的距離（單位為 px）。

畫面排版細節

• 主/次字幕：可精細調整顏色、字型、字重、大小、行高與字距。
• 次字幕佔據空間：
  • 勾選：主字幕使用 "扣除次字幕" 的畫面空間，互不重疊。
  • 不勾選：次字幕將以疊加（Overlay）方式顯示在主字幕之上。

!TIP 建議開啟 文字框預覽 功能，可以更直觀地觀察字幕區塊的佔據範圍。

!IMPORTANT 因字型版權問題，.cuet 專案檔內不包含字型檔，請確保演出電腦已安裝所需字型。

佈景控制

1. 佈景用於點綴畫面，包含圖片、色塊與粒子特效。
2. 佈景層級（前/後景）決定了其與字幕的遮擋關係。
3. 每個佈景皆可綁定獨立熱鍵，讓您在演出時隨心所欲地控制開關。

!IMPORTANT可綁定的按鍵範圍：

• 英文字母 A-Z 與 數字 0-9。
• 方向鍵（上、下、左、右）與 Space (空白鍵)。

觸發方式

• 手動觸發：進入演出模式後，按下對應熱鍵即可切換顯示與隱藏。
• 自動觸發（連動字幕）：在 觸發 模式下，您可以直接在時間軸上點選佈景的出沒區間。當該段字幕進入時，佈景會自動出現；字幕結束時則自動消失。

專案與 OSC 設定

舞台設定

在 專案設定 中，您可以定義最終輸出的寬高度與背景色。建議根據現場投影機的解析度進行設定。

字幕顯示切換

若某些場次不需要次字幕，您可以在 專案設定 中將 字幕顯示 切換為主字幕模式。

OSC 外部連動

CueT 支援標準 OSC 協定，能與專業軟體連動：

• 設定路徑：偏好設定 > OSC 設定。
• 通訊埠：預設為 53000。
• 主要指令：
  • /cue/next : 下一句。
  • /cue/prev : 上一句。
  • /cue/go/{index} : 跳轉至指定編號的字幕。
  • /cue/effect/{key} : 觸發對應熱鍵的佈景開關。

!NOTE OSC 設定屬於「全域設定」，儲存在您的電腦中，不會隨著專案檔 (.cuet) 移動。

演出模式

快速跳轉字幕

於演出模式下，您可以執行快速定位：

1. 按住 Shift 鍵。
2. 輸入目標字幕編號。
3. 按下 Enter 鍵完成跳轉。

演出紀錄與 SRT 導出

CueT 會自動記錄演出時每一句字幕的進出場時戳，並於演出結束後，自動存為演出紀錄。您可在「演出紀錄」表中下載該次演出的 SRT 字幕檔，作為後續影片製作使用。

離開演出模式

在演出模式下，若要離開，您需要連按兩下 Esc 鍵。此設計是為了避免誤觸而中斷演出。

!NOTE 如果只是彩排，使用「預覽模式」即可，預覽模式不會產生演出紀錄，可保持紀錄乾淨。

快捷鍵總表

模式切換

快速管理

執行控制

授權說明 (License)

CueT 為免費軟體，開放個人、商業演出或專業劇團自由下載使用。您不需要支付任何授權費或事前申請。

• 個人使用：免費
• 商業/專業劇團使用：免費
• 修改與再發佈：禁止對軟體進行逆向工程、拆解或未經許可的再分發。

本專案由開發者獨立開發。如果您喜歡這個工具，歡迎請我喝杯咖啡。