Songlist Guide

使用說明中心

搜尋你想完成的事情，例如 OBS 沒聲音、影片空白、歌詞設定或授權過期， 直接找到對應說明，不需要從頭閱讀。

返回首頁返回控制台
全部
開始使用
歌曲與清單
影片與播放
歌詞
OBS
儲存與安全
常見問題

推薦項目

開始使用

Songlist 是什麼歌回直播用的歌單與 Overlay 管理工具。
  • Songlist 用來管理目前演唱歌曲、已演唱清單、影片與歌詞，並把公開歌單與 Overlay 放進 OBS。
  • 第一次使用請先到控制台輸入公開 Key，載入後再依快速上手六步設定。
公開 Key 與管理密碼公開 Key 只能讀取；管理密碼才能修改資料。
  • 使用者 Key 是公開歌單的網址名稱，例如 mayj 對應 /mayj。Key 不是管理密碼，知道網址的人都能讀取公開歌單。
  • 管理密碼用來證明你有權修改這個 Key 的歌曲與 Overlay 設定。第一次儲存時伺服器會建立金鑰並只回傳一次。
  • 金鑰只保存在目前瀏覽器。換瀏覽器、換裝置或按「清除此瀏覽器」後需要重新貼上。
  • 「複製管理密碼」會複製管理密碼，請勿分享給其他人；遺失後無法從伺服器取回原金鑰。
第一次使用流程六步完成 Key、歌曲、影片、歌詞與 OBS 設定。
  1. 設定公開 Key — 載入成功後，公開網址會是 /你的Key。第一次使用的新 Key 會在第一次儲存時建立資料。
  2. 確認管理權限 — 看到「已有管理權限」後就能儲存。金鑰只保存在這個瀏覽器；換瀏覽器或按「清除此瀏覽器」後需要重新貼上，但不會刪除伺服器上的歌曲資料。
  3. 管理歌曲 — 公開歌單會同步顯示目前歌曲與已演唱清單。這兩個操作都不會自動播放或停止影片。
  4. 設定影片 — 確認預覽能播放後，到「OBS 相關」分頁複製含授權網址。YouTube、Vimeo、Twitch 支援遠端控制；Bilibili、Niconico 僅提供嵌入播放。
  5. 設定歌詞 — 按「儲存歌詞設定」保存樣式後，OBS 歌詞來源就會使用這份設定。找不到同步歌詞時，可能只有純歌詞或沒有可用結果。
  6. 設定 OBS — 控制台「OBS 影片」顯示在線後，就能用播放器控制操作 OBS。詳細步驟與排查方式在「OBS 相關」分頁。
  • 設定公開 Key：在頁面上方輸入一個公開 Key，例如 mayj，然後按「載入」。Key 會成為公開歌單網址的一部分。
  • 確認管理權限：第一次儲存時，伺服器會建立管理密碼並只回傳一次。請在看到金鑰後立刻按「複製管理密碼」備份。
  • 管理歌曲：在「目前歌曲」填入歌名，原唱／演唱者與點歌人可選填。按「開始演唱」會更新公開歌單的目前歌曲。
  • 設定影片：在「Overlay 設定 → 影片」貼上影片網址，按「套用影片」。支援 YouTube、YouTube Shorts、Vimeo、Twitch、Bilibili、Niconico。
  • 設定歌詞：到「歌詞」分頁，系統會使用目前歌曲搜尋歌詞（LRCLIB 優先，找不到時可能使用備援來源）；也可以手動輸入歌名與演唱者後按「搜尋歌詞」。
  • 設定 OBS：在 OBS 新增兩個「瀏覽器」來源：影片來源貼上含授權網址，歌詞來源貼上歌詞網址。
網站與 OBS 字體在控制台選擇字體，一次套用到網站與 OBS。
  • 在控制台的「網站與 OBS 字體」選擇字體後會立即預覽；按「儲存字體」後，公開歌單與 OBS 會同步使用。
  • 字體檔放在 public/fonts 並登記在 manifest.json，支援 WOFF2、WOFF、TTF、OTF。
  • 字體必須具備允許 Web 嵌入及公開提供的授權。

歌曲與清單

目前歌曲設定正在演唱的歌曲，不會自動播放或停止影片。
  • 歌名必填；原唱／演唱者選填，主要用於歌詞搜尋；點歌人選填，會顯示在公開歌單。
  • 「開始演唱」會把歌曲設為公開歌單的目前歌曲。
  • 「結束並加入清單」會結束目前歌曲，並自動把這首歌加入已演唱清單。
  • 歌曲管理與影片播放是兩套獨立功能；開始演唱不會自動播放影片。
已演唱清單公開歌單會顯示的已演唱歌曲清單。
  • 格式為每行一首歌，例如「歌名 A - 點歌人 A」；點歌人可以省略。
  • 修改文字後必須按「更新清單」，才會寫入伺服器；更新會以目前編輯內容取代伺服器上的清單。
  • 「清空」只會清空已演唱清單，不影響目前歌曲、影片與歌詞設定。

影片與播放

影片設定貼上影片網址並套用，預覽只影響控制台。
  • 支援 YouTube、YouTube Shorts、Vimeo、Twitch、Bilibili、Niconico。
  • 「套用影片」會儲存設定並載入控制台預覽；「預覽影片」只在控制台播放，不會改變 OBS 畫面。
  • 「清除影片」只會移除影片設定；清除後 OBS 影片來源會沒有內容，播放控制也會失效。
播放器控制播放、暫停、繼續、停止與重新播放的操作差異。
  • 播放：從目前位置開始播放；暫停：暫停目前播放；繼續：從暫停狀態恢復播放。
  • 停止：停止播放並回到開頭；重新播放：從頭重新播放。
  • 只有 YouTube、Vimeo、Twitch 支援遠端控制；Bilibili、Niconico 僅提供嵌入播放。
  • 控制會同時套用到控制台預覽與在線的 OBS；若只有一邊在線，就只控制那一邊。

歌詞

歌詞搜尋使用目前歌曲自動搜尋歌詞，也可手動搜尋。
  • 預設使用目前歌曲的歌名與演唱者搜尋歌詞；修改搜尋欄位後要按「搜尋歌詞」才會使用新條件。
  • 搜尋順序是 LRCLIB 優先；LRCLIB 找不到時會自動使用 Lyrics.ovh 備援，不需要設定 API Key。
  • 手動搜尋每 3 秒限一次；找不到同步歌詞時，可能只有純歌詞或沒有可用結果。
  • 搜尋條件會在約 3 秒內自動同步到 OBS。
完整歌詞顯示歌詞以完整內容顯示在 Overlay 上。
  • 歌詞一律以完整內容顯示，不再逐句切換。
  • 若來源提供的是時間標記歌詞，畫面只會顯示文字，不會出現時間戳。
歌詞進階樣式字級、顏色、對齊、寬度與來源標示。
  • 字級、顏色、對齊與最大寬度會影響 OBS 歌詞畫面。
  • 「顯示歌詞來源標示」預設關閉；開啟後 Overlay 會顯示歌詞來源。
  • 若歌詞來源的授權要求顯示版權標示，就無法隱藏；版權文字會以小型標示顯示在角落。
  • 只調整進階樣式時，請按「儲存歌詞設定」；搜尋條件會自動同步。

OBS

OBS 影片來源使用含授權網址建立瀏覽器來源，並調整音量與靜音。
  • 影片來源必須使用「複製影片來源網址（含授權）」；一般影片 Overlay 網址不會帶授權，無法回報狀態或接受遠端控制。
  • 在 OBS 新增「瀏覽器（Browser）」來源，貼上含授權網址，建議 1920 × 1080，背景透明、自訂 CSS 留空。
  • 影片沒有聲音時：開啟「互動（Interact）」，在播放器內解除靜音或按播放；也可以調整 OBS 音訊混音器的來源音量。
  • 影片音量太大時：可用音訊混音器，或用「互動（Interact）」調整播放器本身的音量。
OBS 歌詞來源歌詞使用獨立的瀏覽器來源，不需要授權。
  • 歌詞來源貼上公開歌詞 Overlay 網址，不需要播放器授權。
  • 影片與歌詞必須是兩個獨立來源；建議把歌詞來源放在影片來源上方，並保持背景透明。
  • 歌詞來源標示預設不顯示；開啟「顯示歌詞來源標示」後才會在 Overlay 角落顯示。需要版權標示的來源會自動保留在角落。
授權期限與更新方式播放器授權有效 12 小時，過期後重新複製更新。
  • 播放器授權有效 12 小時；控制台每 10 分鐘會更新自己的授權，但 OBS 內已貼上的網址不會自動更新。
  • 授權到期後請回控制台重新複製含授權網址，並在 OBS 的瀏覽器來源按「重新整理」或重新貼上。
  • 授權過期通常只影響遠端播放控制與狀態回報，不代表影片畫面一定會停止顯示。

儲存與安全

儲存行為哪些操作立即儲存，哪些會自動同步，哪些要手動儲存。
  • 立即寫入：開始演唱、結束並加入清單、更新清單、清空已演唱清單、套用影片、清除影片、儲存歌詞設定。
  • 約 3 秒後自動同步：搜尋歌詞。
  • 只需要按儲存：只調整進階樣式時，請按「儲存歌詞設定」。若不確定，按一次儲存最保險。
危險操作清空清單、清除影片與清空所有資料的影響範圍。
  • 清空已演唱清單：只移除已演唱清單，不影響目前歌曲。
  • 清除影片：只移除影片設定；清除後 OBS 影片來源會沒有內容，播放控制也會失效。
  • 清除此瀏覽器：只清除本機保存的管理密碼，不會刪除伺服器資料。
  • 清空所有資料：清除目前歌曲、已演唱清單、影片與歌詞設定；管理密碼與公開 Key 保留，公開網址不會失效但會顯示空白。
管理密碼遺失金鑰只回傳一次，遺失後無法從伺服器取回。
  • 管理密碼只在第一次儲存時回傳一次，伺服器不會保存或回傳原金鑰。
  • 遺失後無法直接取回；換瀏覽器或按「清除此瀏覽器」後，也需要重新輸入先前備份的金鑰。
  • 請勿分享管理密碼；公開 Key 只能讀取，不能修改資料。

常見問題

資料無法載入載入失敗時先確認 Key 與網路後重試。
  • 確認 Key 格式正確（文字、數字、底線與減號，最多 64 字元）。
  • 確認網路連線正常後按「重新載入」再試一次。
  • 只輸入 Key 不等於已載入；必須按「載入」或按 Enter。
儲存失敗先確認管理密碼，再確認網路與伺服器錯誤訊息。
  • 確認管理密碼正確，且已按「套用」。
  • 如果顯示「需要重新輸入管理密碼」，貼上先前備份的金鑰。
  • 如果金鑰已遺失，伺服器無法回傳原金鑰。
找不到歌詞更換搜尋條件，或接受純歌詞結果。
  • 手動輸入歌名與演唱者後按「搜尋歌詞」，每 3 秒限一次。
  • LRCLIB 可能只有純歌詞或沒有可用結果；這不代表設定錯誤。
  • 確認目前歌曲已設定，且歌詞分頁顯示已取得歌詞。
影片來源顯示空白OBS 常見問題排查，照步驟優先檢查前面的項目。
  • 確認貼上的是按「複製影片來源網址（含授權）」取得的網址，不是一般影片 Overlay 網址。
  • 確認 OBS 來源類型是「瀏覽器（Browser）」，不是「顯示器擷取」或「視窗擷取」。
  • 在 OBS 對來源按右鍵選擇「重新整理」。
  • 授權可能已過期，回控制台重新複製含授權網址並重新貼上。
影片無法播放OBS 常見問題排查，照步驟優先檢查前面的項目。
  • 先在控制台預覽同一個影片，確認平台允許嵌入播放。
  • 平台可能拒絕在嵌入環境播放，請改用其他影片或平台。
  • 在 OBS 開啟「互動（Interact）」，點擊播放器一次允許播放。
影片沒有聲音OBS 常見問題排查，照步驟優先檢查前面的項目。
  • 確認 OBS 音訊混音器中這個來源沒有靜音，音量也大於 0。
  • 對影片來源按右鍵選擇「互動（Interact）」，在播放器內解除靜音或按播放。
  • 確認影片本身有聲音，且 OBS 沒有把整個來源設為靜音。
歌詞沒有顯示OBS 常見問題排查，照步驟優先檢查前面的項目。
  • 確認目前歌曲已設定，且歌詞分頁顯示已取得歌詞。
  • 確認 OBS 歌詞來源使用的是歌詞 Overlay 網址，不是影片網址。
  • 確認歌詞來源的寬度與高度足夠，背景保持透明。
  • 在 OBS 對歌詞來源按右鍵選擇「重新整理」。
OBS 顯示未連線OBS 常見問題排查，照步驟優先檢查前面的項目。
  • 確認影片來源貼的是含授權網址，且沒有手動修改網址內容。
  • 播放器授權有效 12 小時，過期後請重新複製並更新 OBS 來源。
  • 確認 OBS 正在執行、影片來源已啟用，並在來源按「重新整理」。
播放控制沒有反應OBS 常見問題排查，照步驟優先檢查前面的項目。
  • 確認控制台「OBS 影片」顯示在線，且影片來源使用含授權網址。
  • 只有 YouTube、Vimeo、Twitch 支援遠端控制；Bilibili、Niconico 僅提供嵌入播放。
  • 確認控制台預覽已載入，或 OBS 已回報可控制狀態。
  • 授權過期時請重新複製含授權網址，並更新 OBS 來源。