Skip to content

Latest commit

 

History

History
324 lines (221 loc) · 13.6 KB

MANUAL.md

File metadata and controls

324 lines (221 loc) · 13.6 KB
Raw

自定義工具箱 - 使用手冊

一、功能

二、短片播放器

1. 一般操作

  1. 先在右側的短片清單中新增內容；或使用 網路資源 取得內容。
  2. 點選短片播放器頁籤。
  3. 點選播放按鈕，即可播放短片。

2. 其他控制項

  • 拖曳時間軸，即可調整播放的進度。
  • 拖曳音量調整，即可調整音量大小。
  • 點選靜音按鈕，即可靜音短片。
    • 點選取消靜音按鈕，即可取消靜音短片。
  • 勾選不顯示影像，即可不顯示短片的畫面。
    • 取消勾選不顯示影像，即可顯示短片的畫面。
  • 勾選色度鍵，即可將短片畫面轉換成綠幕。
    • 取消勾選色度鍵，即可顯示原本的短片畫面。
  • 選則 YouTube 影片畫質，即可調整 YouTube 網站影片的畫質。
    • ※僅對 YouTube 網站有效。
  • 選擇播放速度，即可調整短片的播放速度。
  • 點選上一個按鈕，即可播放上一個短片。
  • 點選下一個按鈕，即可播放下一個短片。
  • 點選暫停按鈕，即可暫停播放短片。
    • 點選恢復播放按鈕，即可恢復播放已暫停播放短片。
  • 點選停止按鈕，即可停止播放短片。
  • 點選時間標記編輯器單選按鈕，以切換成時間標記編輯器模式；點選時間標記編輯器單選按鈕，以切換成短片播放器模式。

3. 短片清單

  1. 在短片清單上點選滑鼠右鍵，即可叫出操作選單。
  2. 可以直接將支援的短片清單檔案，拖曳至短片清單上以載入該短片清單的內容。
  3. 可以透過檔案 -> 載入短片清單檔案，選擇要載入的短片清單檔案，即可載入該檔案。

4. Discord 豐富狀態

本應用程式還另支援 Discord 豐富狀態 [^1]（需要在雜項頁籤開啟），可以將短片播放器的播放狀態設為 Discord 豐富狀態。

三、網路資源

點選網路資源頁籤。

1. 網路播放清單

目前共支援下列兩個來源：

選擇欲下載的網路播放清單後，再點選載入短片清單按鈕，即會在右側的短片清單內顯示下載的內容。

2. 自動歌詞

勾選啟用後，若是播放來自 YoutubeClipPlaylist/Playlists 的播放清單中的短片時，若該短片項目沒有字幕檔網址，則會自動搜尋 YoutubeClipPlaylist/Lyrics 此 GitHub 倉庫，並下載對應的 LyRiCs 檔案。

※不一定都找得到對應的 LyRiCs 檔案，詳細請參考該 GitHub 倉庫的 README.md 檔案。

3. 短片清單

此下拉選單會在應用程式開啟時，自動掃描 ClipLists 資料夾，並將該資料夾第一層的短片清單列出。 選擇欲載入的短片清單檔案後，再點選載入短片清單按鈕，即會在右側的短片清單內顯示載入的內容。

4. Bilibili 短片清單產生器

  1. 輸入使用者的 mid。
  2. 點選複製 MID按鈕，即可以從在網路播放清單中所選擇的播放清單來取得 MID。（※僅支援 Bilibili 的播放清單）
  3. 在排除字詞的欄位編輯要排除的字詞。(一行一個字詞)
  4. 勾選匯出成 *.jsonc以匯出 YoutubeClipPlaylist/Playlists 所使用的格式。
  5. 勾選檢查網址以啟用網址檢查功能。
    • 會排除拜年紀這類的影片。
  6. 點選產生短片清單檔案按鈕即可。
  7. 若要取消操作，請點選取消作業按鈕即可。

注意事項

  1. 請注意使用的頻率，太過於頻繁的使用，會容易觸發 Bilibili 網站的風險控制機制。建議一天使用次數最多不要超過 2 次。
  2. 因為技術限制的原因，透過 BiliBili API 取得的影片資訊，無法取得所有的分段相關資訊，故只能固定取得第一分段的資料。

四、下載短片

1. 下載此短片

  1. 先在短片清單點選要下載的短片項目。
  2. 在該短片項目上點選滑鼠右鍵，然後選擇下載此短片。
  3. 等待作業完成即可。
  4. 若要取消操作，請點選取消作業按鈕即可。

2. 依同網址或影片 ID 來下載短片

  1. 先在短片清單點選要下載的短片項目。
  2. 在該短片項目上點選滑鼠右鍵，然後選擇依同網址或影片 ID 來下載短片。
  3. 等待作業完成即可。
  4. 若要取消操作，請點選取消作業按鈕即可。

3. 批次下載短片

  1. 在短片清單上點選滑鼠右鍵，然後選擇批次下載短片。
  2. 等待作業完成即可。
  3. 若要取消操作，請點選取消作業按鈕即可。

4. 下載選項

  1. 先下載完整影片
    • 啟用此選項後，則會先下載整部短片，在下載完成後，才會依短片項目的內容決定是否要分割短片。
  2. 刪除來源檔案
    • 僅會作用於需要分割短片的狀況。

※這兩個設定選項會影響下載此短片以及依同網址或影片 ID 來下載短片等功能。

五、陽春字幕產生器

點選短片工具頁籤後，再點選陽春字幕產生器按鈕，即會透過本機上的網頁瀏覽器開啟該網頁工具。

六、YouTube 影片秒數轉換器

點選短片工具頁籤後，再點選YouTube 影片秒數轉換器按鈕，即會透過本機上的網頁瀏覽器開啟該網頁工具。

七、燒錄字幕檔

  1. 先至雜項頁籤設定 FFmpeg 選項。
  2. 點選短片工具頁籤後，再點選燒錄字幕檔按鈕。
  3. 選擇視訊檔案。(僅支援 *.mp4、*.mkv 等格式)
  4. 選擇字幕檔案。(僅支援 *.srt、*.vtt、*.ssa 以及 *.ass 等格式)
  5. 等待作業完成即可。
  6. 若要取消操作，請點選取消作業按鈕即可。

八、分割影片

  1. 先至雜項頁籤設定 FFmpeg 選項。
  2. 在短片清單加入欲分割成的短片項目。
  3. 點選短片工具頁籤後，再點選分割影片按鈕。
  4. 選擇視訊檔案。(僅支援 *.mp4、*.mkv 等格式)
  5. 等待作業完成即可。
  6. 若要取消操作，請點選取消作業按鈕即可。

九、Whisper

前置步驟

  1. 選擇要使用的模型。
  2. 選擇要使用的量化。
  3. 選擇要使用的取樣策略。
  4. 選擇目標的轉譯語言。
  5. 填入欲使用的 Beam size 的值。
  6. 填入欲使用的 Patience 的值。
  7. 填入欲使用的 Best Of 的值。
  8. 勾選是否要啟用啟用 SpeedUp2x。
  9. 勾選是否要啟用翻譯成英文。
  10. 勾選是否要啟用同時輸出 WebVTT 字幕檔。

1. 偵測影片語言

  1. 完成 Whisper 的前置步驟
  2. 點選偵測影片語言按鈕，並選擇檔案。
  3. 等待作業完成即可。
  4. 若要取消操作，請點選取消作業按鈕即可。

2. 轉譯影片

  1. 完成 Whisper 的前置步驟
  2. 點選轉譯影片按鈕，並選擇檔案。
  3. 等待作業完成即可。
  4. 若要取消操作，請點選取消作業按鈕即可。

注意事項

  1. 請勿用於 Medium 以下的模型。
  2. 當選擇的模型越大，所需要花費的硬體資源，以及處理的時間會變得更多跟更長。
  3. 當取樣策略設為 Default 時，則效果會等同於設為 Greedy。
  4. Beam size 以及 Patience 等欄位的值，只會影響取樣策略 設為 Beam search 時的作業。
  5. Best Of 欄位的值，只會影響取樣策略 設為 Default 或 Greedy 時的作業。

十、YouTube 訂閱者計數器工具

  1. 點選其他工具頁籤。
  2. 輸入 YouTube 頻道的 ID。
  3. 依照需求勾選以及設定選項。
  4. 點選儲存截圖按鈕即可。
  5. 若需要重設，可以透過點選重設按鈕來重設相關的控制項。

十一、雜項

1. 應用程式選項

(1). 語系

本應用程式預設會自動判斷目前作業系統所使用的語系，但也可以手動選擇想要使用的語系。

  1. 選擇想要使用的語系。
  2. 在選擇以及確認後，等待應用程式重新啟動即可。

(2). 使用者代理字串

此處用於部分下載機制使用，避免讓下載來源認為是非正常行為在下載資源。

  1. 在欄位輸入想要的使用者代理字串。
  2. 讓該欄位失焦即可。

※僅會影響新的下載，對正在進行中的下載不會生效，若要使其立即生效，請先取消進行中的下載作業後再重新下載即可。

(3). Sec-CH-UA

此處用於部分下載機制使用，避免讓下載來源認為是非正常行為在下載資源。

  1. 在欄位輸入想要的 Sec-CH-UA。
  2. 讓該欄位失焦即可。

※僅會影響新的下載，對正在進行中的下載不會生效，若要使其立即生效，請先取消進行中的下載作業後再重新下載即可。

(4). 查詢使用者代理字串

  1. 點選查詢使用者代理字串按鈕，即會開啟您預設的網頁瀏覽器，並透過 Google 來查詢該網頁瀏覽器的使用者代理字串。

※可以搭配使用者代理字串、Sec-CH-UA 一起使用。

(5). 不支援的域名

此功能僅用於載入網路播放清單、短片清單，在載入相關資料時會排除在此處設定的域名的短片項目。

  1. 在欄位輸入想要排除的域名。（一行一個）
  2. 讓該欄位失焦即可。

(6). 附加秒數

此功能僅用於載入時間標記資訊檔案，當載入的時間標記資訊檔案僅有開始時間時，則會以此處設定的秒數自動補上結束時間。

  1. 在欄位輸入想要秒數。
  2. 讓該欄位失焦即可。

(7). 啟用 mpv 記錄詳細資訊

勾選此選項以讓 mpv 輸出詳細資訊。

(8). 啟用 Discord 豐富狀態

本應用程式支援將短片播放器的播放狀態，設為 Discord 豐富狀態 [^1]，勾選此選項以啟用此功能。

(9). 啟用 OpenCC S2TWP

此選項僅會作用於 Bilibili 短片清單產生器以及 Whisper。

勾選此選選項後，會自動將影片標題或是字幕檔的內容轉換成繁體中文（異體字轉換：臺灣標準、地域用詞轉換：臺灣模式）。

2. yt-dlp 選項

本應用程式的短片下載功能是透過 yt-dlp 達成，此處提供簡易的 yt-dlp 選項設定功能。

※若需要下載會員限定的影片，請調整此處的 Cookies 選項。

3. FFmpeg 選項

本應用程式的短片分割、燒錄字幕檔以及分割影片等功能皆是透過 FFmpeg 達成，此處提供簡易的 FFmpeg 選項設定功能。

(1). 字幕選項

  1. 在字型清單選擇想要使用的字型。
  2. 或在其之下的欄位內輸入字型的名稱。
  3. 在文字編碼清單選擇想要使用的文字編碼。
  4. 或在其之下的欄位內輸入文字編碼的名稱。
  5. 勾選套用字型設定選項。

※若未勾選套用字型設定選項的話，在執行相關作業時則不會套用相關設定。

(2). 硬體加速

  1. 選擇品牌。
  2. 或選擇 GPU 裝置。
  3. 勾選啟用硬體加速選項。

※若未勾選啟用硬體加速選項的話，在執行相關作業時則不會套用相關設定。 ※使用此選項前，請先確認您使用的裝置支援硬體加速，否則請勿使用此選項，因為可能會造成相關作業失敗。

4. 相依性檔案

此處提供本應用程式的相依性檔案的下載、更新以及重建等功能。

十二、快速鍵

  • Q 鍵：結束應用程式
  • W 鍵：重設彈出視窗的大小與位置
  • E 鍵：開／關彈出視窗
  • R 鍵：開／關彈出視窗的全螢幕顯示
  • T 鍵：隱藏應用程式
  • A 鍵：播放短片
  • S 鍵：暫停／恢復播放短片
  • D 鍵：播放上一個短片
  • F 鍵：播放下一個短片
  • G 鍵：停止播放短片
  • Z 鍵：隨機播放短片
  • X 鍵：隨機排列短片清單
  • C 鍵：開／關不顯示影像
  • V 鍵：開／關靜音
  • U 鍵：更新目前播放中短片的開始時間 [^2]
  • I 鍵：更新目前播放中短片的結束時間 [^2]

※僅在應用程式前景顯示且有焦點時才會生效。

  • [^1] 僅支援 Discord 桌面版。
  • [^2] 需要先切換成時間標記編輯器模式才會有效。