Yark

让 YouTube 归档变得简单。

安装

要安装 Yark，只需下载 Python 3.9+ 和 FFmpeg（可选），然后运行以下命令：

$ pip3 install yark

管理你的 Archive

安装 Yark 后，为你的 archive 起一个名字（例如 "foobar"），并复制目标的 url：

$ yark new foobar https://www.youtube.com/channel/UCSMdm6bUYIBN0KfS2CVuEPA

现在你已经创建了归档，你可以使用 refresh 命令告诉 Yark 下载所有视频和元数据：

$ yark refresh foobar

一旦所有内容下载完成，Yark 将自动为您提供自上次刷新以来变更情况的报告：

查看您的 Archive

查看您的 archive 很简单，只需输入 view 并附上您的 archives 名称：

$ yark view foobar

这会在你的浏览器中弹出一个离线网站，让你可以观看所有视频 🚀

每个视频下方都有一份包含时间线和图表的丰富历史记录报告，此外还有一个笔记功能，允许你添加带时间戳和永久链接的评论 👐

浅色和深色模式均可用，并会根据系统主题自动应用。

详情

以下是使用 Yark 时需要注意的一些事项，包括优点和缺点：

• 如果你只是想更新存档，请不要再次创建新的存档，Yark 会通过时间戳为你累积所有新的元数据
• 欢迎通过此仓库的 issues 标签页提出新功能建议
• 定时功能目前尚未实现，请使用 cron 或类似工具！
• 存档始终是累加的。如果视频在 YouTube 端被删除或标记为私有，Yark 将保留该视频并为其标记 deleted 标签。因此，这些视频将保留在你的本地存档中。

存档格式

存档格式本身很简单，由基于目录的结构组成，包含一个核心元数据文件以及各自目录中的缩略图/视频数据，作为常规文件：

• [name]/ – 您的自包含归档
  • yark.json – 包含所有元数据的归档文件
  • yark.bak – 用于防止数据损坏的备份归档文件
  • videos/ – 包含所有已知视频的目录
    • [id].* – 包含 YouTube 视频数据的文件
  • thumbnails/ – 包含所有已知缩略图的目录
    • [hash].png – 包含其哈希值的缩略图文件

最好花几分钟时间通过查看归档中看起来有趣的文件来熟悉您的归档，所有内容都相当易读。