您的下一位 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，否则请勿触及它