jim60105/backup-dl repository overview

⁠backup-dl

⁠https://github.com/jim60105/backup-dl⁠

此程式可以檢查Youtube頻道、播放清單，並備份影片至Azure Blob Storage
這是一支.Net Core Console Application，並包裝為Linux Container
整合入我的「Youtube錄影伺服器 (Docker Compose)」，可搭配使用

⁠下載

docker pull ghcr.io/jim60105/backup-dl:latest

Also available at quay.io⁠

⁠參數

⁠環境變數

• AZURE_STORAGE_CONNECTION_STRING_VTUBER: Azure Blob Storage的連接字串
• CHANNELS_IN_ARRAY: 欲下載的頻道網址，以陣列傳入
• MAX_DOWNLOAD: (可選)每次執行的最大下載數量，預設為10
• FORMAT: (可選)自訂欲下載的格式，預設為(bv*+ba/b)[protocol^=http][protocol!*=dash]，請參考yt-dlp說明文件⁠
• SCYNCHRONOUS: (可選)以同步的方式執行程式，請只在單執行緒機器使用

⁠Volume Binding

• cookies.txt:/app/cookies.txt 若bind入，則會在下載時用做登入憑證

⁠功能特性

⁠影片下載

• 底層使用yt-dlp⁠做下載 (別人fork youtube-dl出來擴充的專案)
• 使用archive.txt做記錄，不重覆下載影片
• 可傳入多個Youtube頻道，或是Youtube播放清單
• 下載非DASH影片
  (DASH的解釋⁠，簡單來說就是專給網路串流使用的技術格式，而這通常不是最好的影片)
• 可透過環境變數設定下載格式
• 可限制每次執行的最大下載數量
• 限制下載一日前的影片，避免下載到直播中和未轉檔完的影片

⁠影片後處理

• 使用ffmpeg做後處理
• 內嵌封面縮圖
• 將影片描述寫入metadata
• 影片統一打包為mkv

⁠上傳

• 上傳至Azure Blob Storage
• 影片上傳為封存存取層 (存取層的官方說明文件⁠)

⁠其它

• 這是.Net Core Console Application，打包為Linux Container
• 採用非同步設計 - 每載完一部影片就會進入後處理&上傳程序 - 多執行緒併行，最大化使用你的效能資源 - 每片上傳完成後立刻更新archive.txt，不會因中斷container而遺失進度
• 程式重啟後重傳處理 - 程式啟動時會檢查是否有前次已下載，但未上傳完成的mkv暫存檔案。若有就直接進入上傳

⁠使用方式

⁠Docker

• 在本機環境變數中儲存connection string，命名為「AZURE_STORAGE_CONNECTION_STRING_VTUBER」
  連接字串的說明詳見官方說明文件⁠
• docker run

    docker run 
        --env CHANNELS_IN_ARRAY="[\"https://www.youtube.com/channel/UCBC7vYFNQoGPupe5NxPG4Bw\", \"https://www.youtube.com/channel/UC7XCjKxBEct0uAukpQXNFPw\"]" 
        --env AZURE_STORAGE_CONNECTION_STRING_VTUBER 
        --env MAX_DOWNLOAD="10" 
        jim60105/backup-dl

⁠Kubernetes

git clone --depth=1 https://github.com/jim60105/backup-dl.git
cd backup-dl/helm
vim values.yaml
kubectl create namespace backupdl
helm install backup-dl . -n backupdl

⁠LICENSE

GNU GENERAL PUBLIC LICENSE Version 3⁠

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/⁠.