dmunozv04/iSponsorBlockTV
效率与系统工具自托管的 YouTube TV 客户端辅助工具,自动跳过 SponsorBlock 标记的广告段落并按需跳过或静音广告。
项目介绍
iSponsorBlockTV 是一个自托管的 Python 应用,通过 SponsorBlock API 与电视和游戏主机上的 YouTube 客户端配对,自动跳过社区标记的赞助、片头、片尾等片段。它还能在 YouTube 广告可跳过时自动静音并点击「跳过广告」。配对使用 pyytlounge 和 YouTube 电视代码流程,因此兼容 Apple TV、三星 Tizen、LG WebOS、Android TV、Chromecast、Google TV、Roku、Fire TV、Nintendo Switch 以及 Xbox/PlayStation 主机,完整列表见兼容性表格。
快速使用
- 在一台能访问 youtube.com 的机器上运行 iSponsorBlockTV。除非需要在安装时自动发现设备,否则不需要与电视处于同一网络。
- 按安装 Wiki 安装;也可以使用 Docker 镜像或 GHCR 镜像。
- 首次启动时通过 Textual 配置界面发现局域网设备,或使用电视端 YouTube 设置页显示的 TV 代码手动添加设备(使用说明)。
- 连接设备后正常播放,匹配到的 SponsorBlock 片段会被自动跳过。结果是电视端 YouTube 的观看过程不再被这些标记片段打断。
使用约束
- 运行机器需要能访问 youtube.com;自动发现要求设置时与设备在同一局域网。
- 通过 AirPlay 将音频发送到其他音箱时广告静音不会生效;受 YouTube 一侧限制,Shorts 未完全支持(兼容性说明)。
- 项目使用 GPL-3.0 许可证(许可证)。
- 片段数据来自 SponsorBlock 的社区数据库,跳过效果取决于观众提交的内容。
HotRepo 点评
该项目在 2026-11-11 的 GitHub Python 日榜上以新增 73 Star 位列第 10,2023 年 10 月和 2026 年 11 月的两条 Hacker News 讨论分别有 115 条和 61 条评论。有评论者表示在 Apple TV 上配置很少、工作稳定,并指出可以自行选择要跳过的片段类型(讨论)。同一条讨论也提醒它不是 YouTube 平台广告拦截器,只跳过社区标记的视频内赞助片段(评论)。安装前应把这一点作为主要权衡因素。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。