您的下一位 YouTube 媒體經理

它的作用

Pinchflat 是一款自架應用程序，用於下載使用 yt-dlp 建立的 YouTube 內容。它的設計理念是重量輕、獨立且易於使用。您設定如何從 YouTube 頻道或播放清單下載內容的規則，它會完成剩下的工作，並定期檢查新內容。對於想要下載內容以用於媒體中心應用程式（Plex、Jellyfin、Kodi）的人或想要存檔媒體的人來說，它是完美的選擇！

雖然您可以下載單一視頻，但 Pinchflat 最適合從頻道或播放清單下載內容。它也不適合在應用程式內使用內容 - Pinchflat 將內容下載到磁碟，然後您可以使用媒體中心應用程式或 VLC 觀看它。

如果它不適合您的用例，請提出功能請求！您還可以查看這些出色的替代品：Tube Archivist、ytdl-sub 和 TubeSync

特徵

自包含 - 只有一個 Docker 容器，沒有外部相依性
強大的命名系統，可將內容儲存在您想要的位置和方式
易於使用的網路介面，帶有預設，可讓您立即開始使用
對 Plex、Jellyfin 和 Kodi 等媒體中心應用程式的一流支援（文件）
支援向您喜愛的播客應用程式提供 RSS 提要（文件）
自動從頻道和播放清單下載新內容

使用新穎的方法比其他應用程式更快地下載新內容

支援下載音訊內容
用於處理 YouTube Shorts 和直播的自訂規則
Apprise 對通知的支持
允許在設定的時間段後自動重新下載新媒體

這可以幫助提高新內容的下載品質或改進 SponsorBlock 標籤

（可選）自動刪除舊內容（文件）
進階選項，例如設定截止日期和按標題過濾（文件）
可靠的免持操作
可以將 cookie 傳遞給 YouTube 以下載您的私人播放清單（文件）
贊助商整合
[進階] 允許自訂yt-dlp選項（文件）
[進階] 支援在下載/刪除媒體後執行自訂腳本（alpha - 文件）

截圖

捏平螢幕截圖

安裝

解除突襲

只需在社群應用程式商店中搜尋 Pinchflat 即可！

波爾泰納

重要的

請參閱下面有關在網路文件共用上儲存配置的註解。如果可能的話，最好將配置儲存在本機磁碟上。

Docker 撰寫文件：

 version: '3'services:inchflat:image:ghcr.io/kieraneglin/pinchflat:latestenvironment: # 將時區設定為您本地時區
      - TZ=美國/紐約港：
      -「8945:8945」卷：
      - /主機/路徑/到/配置：/配置
      - /主機/路徑/到/下載：/下載

碼頭工人

在主機上建立兩個目錄：一個用於儲存配置，另一個用於儲存下載的媒體。確保它們都可由執行 Docker 容器的使用者寫入。
透過以下兩種方式之一準備 docker 映像：

注意：也可在 Docker Hub 上取得，網址為keglin/pinchflat:latest

來自 GHCR： docker pull ghcr.io/kieraneglin/pinchflat:latest
本機建置： docker build . --file docker/selfhosted.Dockerfile -t ghcr.io/kieraneglin/pinchflat:latest

運行容器：

 # 請務必將下面的/host/path/to/config 和/host/path/to/downloads 替換為# 您在步驟1 中建立的目錄的路徑# 請務必將America/New_York 替換為您的本地時區docker run
   -e TZ=美國/紐約
   -p 8945:8945
   -v /主機/路徑/到/config:/config
   -v /主機/路徑/到/下載：/下載
   ghcr.io/kieraneglin/pinchflat：最新

重要提示：檔案權限

您必須確保執行 Docker 容器的使用者可寫入已安裝的主機目錄。如果您收到權限錯誤，請按照建議的步驟操作。有關更多信息，請參閱#106。

重要的

不建議以 root 身分執行容器。如果其他應用程式需要使用下載的媒體，這樣做可能會產生權限問題。

進階：在網路共用上儲存 Pinchflat 設定目錄

如 #137 所指出的，SQLite 不喜歡在網路共用上以 WAL 模式運作。如果您在網路共用上執行 Pinchflat，則可以透過將JOURNAL_MODE環境變數設為delete來停用 WAL 模式。這將使 Pinchflat 在回滾日誌模式下運行，該模式效能較低，但應該可以在網路共用上運行。

警告

可以想像，在現有 Pinchflat 實例上將此設定從 WAL 更改為delete可能會導致資料遺失。只有當您知道自己在做什麼、為什麼這很重要並且可以接受可能的資料遺失或資料庫損壞時，才更改此設定。先備份資料庫！

如果您更改此設定並且它對您有效，請在#137 上發表評論！如果效果不佳，則加倍。

環境變數

姓名	必需的？	預設	筆記
`TZ`	不	`UTC`	必須遵循 IANA TZ 格式
`LOG_LEVEL`	不	`debug`	可以設定為`info`但強烈建議進行`debug`
`BASIC_AUTH_USERNAME`	不		請參閱身份驗證文檔
`BASIC_AUTH_PASSWORD`	不		請參閱身份驗證文檔
`EXPOSE_FEED_ENDPOINTS`	不	`false`	請參閱 RSS 來源文檔
`ENABLE_IPV6`	不	`false`	設定為任何非空值都將啟用 IPv6
`JOURNAL_MODE`	不	`wal`	如果您的設定目錄儲存在網路共用上，則設定為`delete` （不建議）
`TZ_DATA_DIR`	不	`/etc/elixir_tzdata_data`	儲存時區資料庫的容器路徑
`BASE_ROUTE_PATH`	不	`/`	路由產生的基本路徑。在某些反向代理後面運行時很有用，但必須刪除前綴。
`YT_DLP_WORKER_CONCURRENCY`	不	`2`	每個隊列使用`yt-dlp`的並發工作執行緒數。如果您的 IP 受到限制，請設定為 1，否則請勿觸及它