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 <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