Pinchflat
一款自托管的 YouTube 媒体下载管理器，自动抓取频道更新并提供友好的 Web 界面，支持 Plex 等媒体中心。
スマートダウンロード
プロジェクトのホームページへ
インストーラはまだありません — ソースリポジトリをご覧ください
一键订阅频道，自动下载 YouTube 视频并整理进媒体库。
主な機能
- 单 Docker 容器部署，无外部依赖
- 强大的命名规则：自定义文件存储位置和格式
- 自动检测并下载新内容，周期可调
- 支持仅下载音频，方便播客管理
- 内置 RSS 订阅源，可用于播客客户端
できないこと
- •Pinchflat 不提供视频播放功能，需配合 Plex/Jellyfin/VLC 等播放器；首次使用需注意挂载目录权限：Docker 容器内用户需对目录有写权限；若使用网络存储（NAS/NFS），建议将配置存放在本地磁盘避免 I/O 问题；反向代理需额外配置 WebSocket 或 API 路径。
使用例
- 将 YouTube 教学频道或 Vlog 归档到本地媒体服务器
- 定期下载播客类频道并导入播客 App 离线收听
- 备份自己喜欢的 YouTube 播放列表到本地
詳細説明
Pinchflat 是一个基于 yt-dlp 的自托管 YouTube 下载管理器。你只需设置频道或播放列表的下载规则，Pinchflat 就会定期检查新视频，自动下载并按照你设定的命名规则整理到本地磁盘。它运行在单个 Docker 容器中，无需任何外部依赖，自带简洁的 Web 界面。支持仅下载音频、处理 Shorts 和直播、集成 SponsorBlock、自动重下以获取更高画质、定时删除旧媒体、为播客应用提供 RSS 订阅，以及高级自定义 yt-dlp 参数。非常适合把 YouTube 内容归档到 Plex、Jellyfin 或 Kodi 等媒体中心使用。
トラブルシューティング & FAQ (1)
トラブル対応なぜPinchflatは、YouTube以外のソースからダウンロードしたファイルを、ビデオタイトルではなくソースファイル名で保存するのですか？
Pinchflatは、非YouTubeダウンロードの出力パステンプレートにおいて、ソースファイル名をtitle変数として誤って使用します。回避策として、目的の出力テンプレートを指定して手動でyt-dlpを実行してください。例：yt-dlp <url> --output "/downloads/path/%(title)s.%(ext)s"。恒久的な修正がリリースされたときは、issue #846を追跡してください。
タグ
はじめ方
ソフトウェアをインストール
ダウンロードしたインストーラをダブルクリックし、指示に従ってください
步骤1：确保已安装 Docker，拉取镜像：docker pull ghcr.io/kieraneglin/pinchflat:latest
步骤2：创建本地目录（如 /data/pinchflat/config 和 /data/pinchflat/downloads）并给予写权限
步骤3：运行容器，映射端口 8945，挂载两个目录，设置时区：docker run -d -p 8945:8945 -v /data/pinchflat/config:/config -v /data/pinchflat/downloads:/downloads -e TZ=Asia/Shanghai ghcr.io/kieraneglin/pinchflat:latest
- 步骤1：确保已安装 Docker，拉取镜像：docker pull ghcr.io/kieraneglin/pinchflat:latest
- 步骤2：创建本地目录（如 /data/pinchflat/config 和 /data/pinchflat/downloads）并给予写权限
- 步骤3：运行容器，映射端口 8945，挂载两个目录，设置时区：docker run -d -p 8945:8945 -v /data/pinchflat/config:/config -v /data/pinchflat/downloads:/downloads -e TZ=Asia/Shanghai ghcr.io/kieraneglin/pinchflat:latest
チェックサムがありません
このプロジェクトは GitHub Release ページに SHA-256 チェックサムを公開していません
SHA256 チェックサム
チェックサムなし
GitHub Releases から直接ダウンロードし、ファイルの整合性をご自身で確認してください
本プラットフォーム上のすべての SHA-256 チェックサムは、プロジェクトの公式 GitHub Release ページから抽出されたもので、一切の改変はありません。GitHub Releases ページで独自に検証できます。
オープンソースの透明性
GitHub ソースを見るアンインストール情報
停止并删除容器：docker stop pinchflat && docker rm pinchflat。可删除本地映射的 config 和 downloads 目录清理所有数据。
追加の依存関係なし
ダウンロード後すぐに使用可能。追加のランタイムは不要です。
問題が発生？以下のFAQを確認
1 FAQ