FB 直式短影音製作（繁中字幕）

一句話

丟一支（或一整個資料夾的）影片進去，拿到可以直接上傳 Facebook Reels 的成品：9:16 直式、繁體中文字幕已經燒進畫面。

它幫你做什麼

拍好的影片要發 Reels，中間這段瑣事它全包了：

• 轉直式 — 橫式、方形、各種奇怪比例的素材，統一鋪成 1080×1920，邊緣用純色或模糊背景填滿
• 上字幕 — 語音自動辨識成繁體中文（台灣用語），切成適合閱讀的長度，燒進畫面
• 修錯字 — 內建專有名詞校正表，把辨識老是聽錯的詞一次改對
• 剪掉廢話 — 用一個文字檔標記要刪的秒數區間，停頓、講錯、重來都能剪掉
• 接片尾 — 可選擇在結尾接上你自己的品牌片尾
• 批次處理 — 一次跑完整個資料夾，30 支不用開 30 次

適合誰

• 固定經營 Facebook / Reels 的個人品牌
• 需要穩定產出短影音的小型行銷團隊
• 手上素材多、每支都要上字幕的內容創作者

如果你一個月只發一兩支，手動剪可能更快。這個工具的價值在量。

你需要準備

安裝步驟都寫在 references/setup.md，含三個作業系統的指令和疑難排解。

怎麼用

單支

python scripts/prep.py "影片.mp4"          # 轉直式、套用剪除清單
python scripts/transcribe.py "工作區/影片_prep.mp4"   # 產生字幕
python scripts/render.py "工作區/影片_prep.mp4"       # 燒字幕、接片尾、輸出

整個資料夾

python scripts/batch.py "待處理資料夾" --stage 1   # 前製 + 產字幕
# 檢查一下字幕
python scripts/batch.py "待處理資料夾" --stage 2   # 算圖輸出

為什麼分兩階段？ 因為字幕一旦燒進畫面就改不掉了。中間留一個檢查點讓你掃過 srt，比 30 支算完才發現錯字整批重來好。

專有名詞校正表

語音辨識最常錯在人名、品牌名、專業術語 —— 而那些偏偏最不能錯。

在設定檔列出正確寫法和它常被聽成的樣子，之後每支都自動修：

"glossary": {
  "Google": ["谷歌", "咕狗", "古哥"],
  "按讚": ["按贊", "安讚"]
}

一個正確詞可以對應多種錯法。產生字幕時會在轉繁體之後套用，並印出這次改了哪些詞、各幾處，你看得到它做了什麼。

剪掉不要的片段

在影片旁邊放一個同名的 .cuts.txt，寫下要刪掉的區間：

0:03.2-0:05.8
0:11-0:12.5

秒數、分秒、時分秒都能寫。跑前製時自動套用。

不用改程式就能調的東西

所有設定集中在一個 config.json：

字幕大小、字型、顏色、外框、位置、一行幾個字、背景要純色還是模糊、輸出畫質、辨識模型大小、專有名詞校正表、片尾路徑、輸出資料夾。

字幕預設離畫面底部 420px，是為了避開 Facebook 介面遮擋區（帳號名稱、按讚分享那一排）。這個數字的由來寫在 references/facebook-specs.md。

輸出規格

依 Meta 對 Reels 的建議值設定。要改成 4:5 或 1:1 也可以，改設定檔的寬高即可。

老實說的限制

• 字幕只做繁體中文（台灣用語），不支援英文或其他語言
• 不會幫你上傳到 Facebook。它產出檔案，發布還是你自己來
• 字幕建議人工看過。語音辨識沒有 100%，校正表能減少大部分重複性錯誤，但第一次跑仍建議掃一遍
• 第一次執行要下載語音模型（約 500MB），需要連網，之後就存在本機
• 需要自己安裝 ffmpeg，這不是 Python 套件，要用系統的套件管理員裝

常見問題

會把我的影片傳到雲端嗎？
不會。語音辨識用的是在你電腦上執行的 faster-whisper，影片和語音內容不會送到任何第三方服務。唯一的連網是第一次下載模型。

素材不是 9:16 會被裁掉嗎？
不會裁掉畫面，是等比縮放後把空白處填滿。背景可選純色或模糊填滿。

30 支要跑多久？
15 秒的影片、用 small 模型、一般筆電，第一階段大約 10–20 分鐘。算圖階段看畫質設定。

可以不要字幕嗎？
可以，不產生 srt 直接算圖就好。片尾同理，預設就是關的。

辨識出影片裡沒講的話？
通常是背景音樂被當成人聲。可以換大一點的模型，或直接手改 srt。