SmartTube:给 Android TV 的开源媒体客户端
一个给 Android TV 看公开媒体内容的开源客户端,不用 Google Services,还能跳过 SponsorBlock 片段。
GitHub yuliskov/SmartTube 更新 2026-09-13 分支 master 星标 33.2K 分叉 2.0K
Java Android TV SponsorBlock 8K/HDR 播放

🧭 决策指南

适合,如果你

  • 你使用 Android TV 或 TV box,并需要 8K、HDR、60fps 播放。
    README 的 SmartTube 与 Features 章节列出 Android TVs、TV boxes、8K resolution、60fps playback 和 HDR compatibility。
  • 你希望在电视端使用 SponsorBlock、变速和自定义按钮。
    README 的 Features 章节列出 SponsorBlock integration、Adjustable playback speed 和 Customizable buttons。
  • 你的设备不依赖 Google Services,且能接受 APK 侧载。
    README 的 Features 章节写明 Does not require Google Services;Installation 章节提供 Downloader、文件传输、USB 和 ADB 方法。
  • 你使用 Xiaomi 中国固件,并愿意安装 stable release。
    README 的 Installation (Xiaomi devices with Chinese firmware) 章节称中国固件可能阻止 beta,并推荐使用 stable version。

不适合,如果你

  • 你需要直接下载视频文件。
    README FAQ 的 Q: Can I download videos? 明确回答 Not with SmartTube。
  • 你只能从应用商店、APK 网站或博客安装 APK。
    README Installation 章节明确要求不要从 app store、APK websites 或 blogs 下载,并称这些版本可能含恶意软件或广告。
  • 你使用 Xiaomi 中国固件且必须安装 Beta 版本。
    README 的 Xiaomi devices with Chinese firmware 章节称该固件可能阻止 beta version,并推荐 stable version。
  • 你的设备无法处理 AV01,且没有足够 CPU 运行软件解码。
    README FAQ 的 AV01 问题说明多数电视和 TV box 没有 AV01 硬件支持;无硬件支持时需要强 CPU,相关修复目前未计划。

前置条件

  • 运行环境应是 Android TV 或 TV box;README 将 SmartTube 定义为 Android TVs 和 TV boxes 的客户端。
  • 安装可使用 Downloader by AFTVnews、文件传输应用、USB,或高级用户使用 ADB;README Installation 章节列出这些方法。
  • Chromecast with Google TV 需要先启用 Developer Options 和 Unknown sources;README 的 Chromecast with Google TV 章节如此说明。
  • 若安装后启动崩溃,README 要求安装到 internal memory,而不是 SD card 或 external storage。
  • 安装来源应使用 README 提供的 beta/stable 地址或 GitHub Releases,不应使用第三方 app store、APK 网站或博客。

要注意

  • 开发环境曾被未知恶意软件感染,部分构建可能受影响。
    README 的 Important announcement about the app 章节直接说明 few builds may have been affected。
  • README 称 public keys 可能已泄露,并要求关注新版本和新公钥。
    README 的 Important announcement about the app 章节提到 Public keys may have been compromised。
  • Chromecast 安装前必须开启 Unknown sources。
    README 的 Installation (Chromecast with Google TV) 章节要求在 Apps > Security & Restrictions 中启用 Unknown sources。
  • Android 预装文件管理器无法用于 USB 安装。
    README Installation 章节明确写明 Android's preinstalled file manager does not work,并列出 FX File Explorer 与 X-plore。
  • 安装后崩溃时,外部存储可能是原因之一。
    README Troubleshooting 说明应用应安装到 internal memory,而不是 SD card 或 external storage。
  • VP9 高分辨率在不支持 4K 的廉价 TV box 上可能变慢。
    README FAQ 的 AV01/VP9 问题说明 cheap TV boxes 可能无法流畅处理高分辨率 VP9。

替代方案

  • SmartTube stable release:Xiaomi 中国固件可能阻止 Beta 时,README 推荐使用 stable version。
    Installation (Xiaomi devices with Chinese firmware)
  • SmartTube beta release:希望比 stable 更快获得新功能和 bugfixes 时,README 称 Beta 更新更快且推荐使用。
    Installation

材料未说明

  • README 节选没有提供完整的 Device support、Compatibility 和 Limitations 内容,具体支持的 Android 版本与设备型号未知。
  • README 节选没有说明 SmartTube 的数据收集、隐私策略和网络请求范围。
  • README 节选没有说明 Chromecast、Casting、Picture-in-Picture 和 HDR 的完整兼容矩阵。
  • README 节选没有给出构建步骤,虽然项目技术栈包含 Java、C++、Kotlin、Makefile 和 Shell。
  • README 节选没有说明 32.47 Beta 相对 stable release 的具体变更内容。
  • README 节选没有说明 10 名贡献者如何分布、维护响应时间或未来版本计划。
  • README 没有提供可直接复制执行的安装命令,因此 first_step 为空字符串。

💡 深度解析

6
不适合 我维护 Samsung Tizen、LG webOS 和 Roku 三个平台的电视应用,想统一采用 SmartTube 的客户端方案;它能否覆盖这些非 Android TV 平台?
适合读者: 同时维护 Samsung Tizen、LG webOS 和 Roku 电视应用的跨平台开发者

不适合,因为 SmartTube 的目标平台是 Android TV 和 Android TV Box,README 还明确把 Samsung Tizen、LG webOS 和 Roku 列为不能安装的系统。

  • 项目描述是“Browse media content with your own rules on Android TV”,核心定位不是跨平台电视客户端。
  • README 的 FAQ 直接列出“Can I install this on a Samsung Tizen TV / LG webOS TV / Roku / iOS?”,对应答案是否定的。
  • 项目主题和实现数据集中在 android、android-tv、android-tv-box、Java、Kotlin、Retrofit2 和 RxJava Android,显示其技术栈是 Android 原生应用,而不是 Tizen、webOS 或 Roku 应用。
  • MIT License 允许复用代码,但许可证不会自动提供这些平台的运行时、UI 框架、播放器或分发包。

因此,它可以作为 Android TV 端实现参考,却不能直接统一覆盖你的三个平台。README 没有提供跨平台移植层或非 Android 构建目标。

  • 项目描述:Browse media content with your own rules on Android TV
  • FAQ:Can I install this on a Samsung Tizen TV / LG webOS TV / Roku / iOS?
  • 项目主题:android、android-tv、android-tv-box、java、kotlin、retrofit2、rxjava-android
  • 项目数据:MIT License;主语言 Java
材料未说明:项目是否存在未在 README 中说明的 Tizen、webOS 或 Roku 分支;移植到其他平台时是否有独立的播放器和界面实现计划
视情况 我使用 Chromecast with Google TV,愿意通过 ADB 侧载 APK,但项目曾披露开发环境感染恶意软件;在这种安全约束下,我是否应该安装 SmartTube?
适合读者: 拥有 Chromecast with Google TV、具备 ADB 侧载能力并关注 APK 供应链安全的高级用户

视情况,因为 SmartTube 的安装方式和安全补救措施都写得很明确,但 APK 来源、签名和账户授权仍需要用户自行承担验证责任。

  • Installation 明确要求不要从应用商店、APK 网站或博客下载,并建议使用项目 GitHub Releases 或指定入口。
  • README 披露开发环境曾感染未知恶意软件,少数构建可能受影响;项目随后进行了磁盘清理,并说明构建会用 VirusTotal 扫描。
  • README 说明公开密钥可能已泄露,并提供新版本和新公钥;这意味着版本和签名核验不能被忽略。
  • ADB 被列为高级安装方式,Chromecast with Google TV 还需要按设备说明开启开发者选项和安装来源权限。

若你无法确认 APK 来源、新公钥或版本对应关系,则不适合安装。README 没有提供完整的可复现构建流程、当前公钥指纹或独立安全审计报告。

  • Important announcement about the app:development environment was infected;Public keys may have been compromised
  • Installation:Do not download SmartTube from any app store, APK websites or blogs
  • Installation:If you are an advanced user, you can install it using ADB
材料未说明:当前公钥的可核验指纹及其与最新版本 32.47 的对应关系;最新 APK 是否提供可复现构建证明或独立第三方审计结果
适合 我使用不依赖 Google Services 的 Android TV Box,主要播放 1080p 内容;设备可能没有 AV1 硬件解码,我是否适合用 SmartTube 替代官方客户端?
适合读者: 使用不依赖 Google Services 的 Android TV Box、且设备硬件较旧的影音用户

适合,因为 SmartTube 明确面向 Android TV 和电视盒子,并且不要求 Google Services;对没有 AV1 解码器的旧设备,也可以使用 VP9 或 AVC。

  • README 的 Features 写明“不需要 Google Services”,适合非 Google 认证设备。
  • 编码建议将 VP9 列为“大多数设备的最佳选择”,AVC 则适用于旧硬件或较慢设备。
  • README 明确警告,多数电视和电视盒子没有 AV1 硬件支持;VP9 高分辨率在廉价、不正式支持 4K 的盒子上也可能变慢。
  • 该项目提供遥控器友好的电视界面、SponsorBlock、播放速度和直播聊天等功能,替代官方客户端的主要观看流程是覆盖的。

如果设备只有较弱 CPU,应避免把 AV1 当作默认选择;但 README 没有给出具体 CPU、内存或各型号盒子的兼容性清单。

  • Features:Does not require Google Services
  • Which codec to choose / overview:VP9 is the best choice on most devices;AVC is for old or slow hardware
  • FAQ:most TVs and TV boxes do not offer hardware support for AV01
材料未说明:该具体 Android TV Box 的 CPU、内存、VP9/AVC 硬件解码能力和系统版本;该设备是否存在厂商固件导致的播放或安装兼容性问题
视情况 我只有一台 Android TV,平时更看重稳定性,但又想尽快使用 SmartTube 的新功能;README 里的 Beta 和 Stable 该怎么选?
适合读者: 使用 Stable Android TV 应用、但又想尽快获得新功能和修复的单设备用户

视情况;如果这台 Android TV 是主要观看设备,应优先 Stable,如果你愿意接受更快变化和潜在兼容回归,Beta 才更匹配。

  • Installation 明确提供 beta release 和 stable release 两个通道。
  • README 写明 Beta 比 Stable 更快获得新功能和 bugfix,因此它的更新速度优势是明确的。
  • 项目还提供内置更新机制和变更记录,适合侧载应用持续维护,但 README 没有承诺 Beta 与所有设备的兼容性相同。
  • 项目功能涉及编码、HDR、AFR、SponsorBlock、投屏和 PiP;这些能力都受设备与系统限制,版本变化可能影响具体硬件组合。

你的约束只有一台设备且重视稳定时,Stable 的决策风险更低;如果某项新修复只在 Beta 中存在,则可考虑 Beta。README 没有给出 Beta/Stable 的兼容性矩阵、回滚流程或每个版本的风险等级。

  • Installation:There is a beta release and a stable release
  • Installation:Beta gets new features and bugfixes faster than the stable release
  • README 章节列表:Updating、Compatibility、Device support
  • Features:HDR compatibility、Customizable buttons;README 章节列表:Casting、Picture-in-Picture (PiP)
材料未说明:当前 Beta 与 Stable 对具体 Android TV 型号的兼容性差异;是否支持无损回退到旧版本,以及回退时是否保留设置和账户连接;每个版本是否提供可比较的已知问题和回归清单
视情况 我的 Android TV 支持 4K、HDR 和 60fps,但我不确定它是否能硬件解码 AV1;我能否用 SmartTube 稳定播放高规格视频?
适合读者: 拥有支持 4K、HDR 和 60fps 的 Android TV、希望优化高规格播放的影音发烧友

视情况,因为 SmartTube 提供 8K、60fps、HDR 和多种编码选项,但 README 明确把实际流畅度交给设备硬件解码、CPU、显示器和网络条件。

  • Features 列出 8K resolution、60fps playback 和 HDR compatibility,说明客户端能暴露这些播放能力。
  • 编码表显示 AV1 压缩效率最高,但 README 说多数电视和电视盒子没有 AV1 硬件支持;VP9 通常更现实,AVC 兼容范围最广。
  • README 还指出,即使设备标称支持高分辨率,VP9 高分辨率在廉价或不正式支持 4K 的盒子上仍可能变慢。
  • AFR 能让电视刷新率匹配内容,可能略微改善流畅度,但“不适用于每种硬件”;出现问题时应关闭。

因此,4K/HDR/60fps 的菜单支持不等于稳定播放。README 没有列出你的电视型号、HDR 制式或具体解码器的验证结果。

  • Features:8K resolution support;60fps playback;HDR compatibility
  • Which codec to choose / overview:AV1 has the best compression;VP9 is the best choice on most devices
  • FAQ:High resolutions might also be slow in VP9 on cheap TV boxes
  • FAQ:AFR does not work well on every hardware
材料未说明:电视的具体型号、HDR 制式、AV1/VP9 硬件解码器和网络带宽;README 未提供针对该设备的 4K、HDR、60fps 联合播放测试结果
视情况 我维护一个以 Java 为主、同时使用 Kotlin 的 Android TV 应用,想复用 SmartTube 的代码或交互设计;MIT 许可和项目规模是否适合长期分叉?
适合读者: 负责 Android TV 端 Java 应用的开源维护者,想在 MIT 许可下复用电视界面和播放控制思路

视情况,因为 MIT License 对复用友好,技术栈也与 Java/Kotlin Android TV 应用匹配,但项目规模很大,且 README 没有完整架构图或构建说明,长期分叉成本无法仅凭许可证判断。

  • 项目数据标明许可证为 MIT License,可作为代码复用和二次分发的法律基础。
  • Java 代码量约 14,979,309 字节,另有 C++、Kotlin、Makefile 和 Shell;这不是一个只含少量界面代码的轻量示例。
  • 项目主题包含 Android TV、Retrofit2 和 RxJava Android,与 Android 原生电视客户端的网络和异步处理场景相符。
  • README 功能涉及 SponsorBlock、编码选择、HDR、AFR、投屏、PiP 和更新机制,说明分叉可能牵涉播放、账户、设备兼容和分发安全多个边界。

若只是借鉴交互,适合;若要维护完整长期分支,则需要先确认构建、模块边界、上游同步方式和发布签名策略。README 未说明这些工程细节。

  • 项目数据:license 为 MIT License
  • 项目数据:Java 14979309、C++ 75253、Kotlin 58378、Makefile 13595、Shell 5299
  • 项目主题:Android TV、Retrofit2、RxJava Android
  • Features:SponsorBlock、8K、60fps、HDR、Customizable buttons、Does not require Google Services
材料未说明:README 未提供完整模块架构、构建命令和依赖锁定方式;上游项目的贡献流程、分支策略和 API 兼容承诺;分叉后如何处理 APK 签名、公钥轮换和内置更新器

✨ 核心亮点

  • 支持 8K、60fps 与 HDR 播放
  • 集成 SponsorBlock,可跳过视频片段
  • 无需 Google Services,支持自定义按钮
  • 最新版本为 32.47 Beta,采用 MIT License

🔧 工程化

  • 面向 Android TV 与 TV box 的电视优化媒体界面
  • 提供 SponsorBlock、变速、直播聊天和 HDR
  • 支持 AV01、VP9 与 AVC 编解码选择

⚠️ 风险

  • README 称部分构建可能受恶意软件感染
  • README 警告应用商店 APK 可能含恶意软件或广告
  • Chromecast with Google TV 默认阻止安装应用
  • 小米中国固件可能阻止 SmartTube Beta 安装

👥 适合谁?

  • 使用 Android TV 或 TV box 看公开媒体内容的人
  • 需要 8K、60fps、HDR 或 SponsorBlock 的电视用户
  • 能接受 APK 侧载、Downloader 或 ADB 的用户