yuliskov/SmartTube

来源：https://github.com/yuliskov/SmartTube

关于应用的重要公告

我的开发环境感染了未知恶意软件，导致少数构建版本可能受到影响。问题被发现后，我已通过全盘擦除确保安全，恢复了干净的环境，现在所有构建都经过VirusTotal扫描验证。F-Droid版本在发布前也将接受验证。

公开密钥可能已泄露，因此我在此说明情况。您可以在下方下载新版本和新的公开密钥，并提供了恢复备份的说明。由于应用使用一次性连接码，无需额外操作。这些代码权限非常有限（例如无法更改您的密码）。但如果您想完全安心，可以随时撤销它们。

如何撤销访问权限：

1. 打开 myaccount.google.com/security (https://myaccount.google.com/security)
2. 找到**“您对第三方应用和服务的关联”**
3. 点击**“查看所有关联”**并找到 YouTube TV 或 Google Drive
4. 选择应用 → “移除访问权限”

请保持内置安全功能启用以保障安全。

SmartTube

应用截图

SmartTube 是一款面向 Android 电视和电视盒的免费开源媒体客户端。它允许您在电视优化的界面中浏览和播放来自各种公开来源的内容。

✅ 功能特点

• 简洁界面
• 集成 SponsorBlock
• 可调节播放速度
• 支持 8K 分辨率
• 60fps 播放
• HDR 兼容性
• 查看实时聊天
• 可自定义按钮
• 无需 Google 服务
• 有益的国际社区

❌ 局限性

• 不支持手机和平板电脑
• 评论功能不稳定
• 语音搜索和投射性能可能不如官方应用（取决于您的设备）

试试看吧！ 有任何疑问？ 先用 Ctrl+F 或 ⌘F 搜索本说明文档！

安装 | 官方网站 (https://smarttubeapp.github.io) | 捐赠 | 常见问题 | 支持/聊天 | 构建 | 翻译应用 (https://jtbrinkmann.de/tools/android-strings.xml-translator.html) | 更新日志 (https://t.me/s/SmartTubeNewsEN) | 免责声明

设备支持

从 2025 年 10 月起，新的 Amazon FireTV 设备将不再运行底层的 Android 系统。SmartTube 将不兼容 Fire TV Stick 4K Select 及更新的运行 Amazon 自有 VegaOS 的设备。

设备支持示意图

• 支持： 所有 Android TV 和电视盒（包括 2025 年 10 月前发布的所有 FireTV 设备、NVIDIA Shield 和带 Google TV 的 Chromecast），甚至包括运行 Android 4.3 (Kitkat) 的旧设备。
• 不支持： 智能手机、非 Android 平台（如三星 Tizen、LG webOS、Apple TV 等）。

安装

安装视频演示 （注意：下载网址已更改为 kutt.to/stn_beta 或 kutt.to/stn_stable）

请勿从任何应用商店、APK 网站或博客下载 SmartTube；这些文件由他人上传，可能包含恶意软件或广告。SmartTube 未在任何应用商店官方发布。

有测试版（推荐）和稳定版。测试版比稳定版更快获得新功能和错误修复。

您可以使用以下任一方法安装应用：

• （最简单）在您的 Android TV 上安装 AFTVnews Downloader (https://www.aftvnews.com/downloader/)，打开它并输入 kutt.to/stn_beta 或 kutt.to/stn_stable，然后阅读、理解并确认安全提示。（您也可以输入 79015 (https://aftv.news/79015) （测试版）或 28544 (https://aftv.news/28544) （稳定版），但这需要额外步骤安装 AFTVnews Downloader 浏览器插件（如果尚未安装）。）
• 在您的 Android TV 上安装文件传输应用，在手机或电脑上下载 APK 并将其传输到电视（例如 Google Play 商店 / Amazon AppStore 中的 Send Files to TV (https://sendfilestotv.app/)）。
• 将 APK 下载到 USB 盘，将 USB 盘插入电视，并使用 Google Play 商店 / Amazon AppStore 中的文件管理器应用（例如 FX File Explorer (https://play.google.com/store/apps/details?id=nextapp.fx) 或 X-plore (https://play.google.com/store/apps/details?id=com.lonelycatgames.Xplore)）。Android 预装的文件管理器无效！不要安装充斥广告的 FileCommander。
• 如果您是高级用户，可以使用 ADB 安装。 指南 (https://fossbytes.com/side-load-apps-android-tv/#h-how-to-sideload-apps-on-your-android-tv-using-adb) | 替代指南 (https://www.aftvnews.com/sideload/)

故障排除： 请参阅下面的设备特定说明。如果安装失败，可能是您的磁盘空间已满或 APK 文件下载不正确；请清理空间并尝试重新下载。如果应用已安装但打开时崩溃，请确保将其安装到内部存储，而不是 SD 卡/外部存储。

应用内置更新器，附带更新日志。您也可以在 Telegram 频道 @SmartTubeNewsEN (https://t.me/s/SmartTubeNewsEN)（无需账号即可查看）或 GitHub (https://github.com/yuliskov/SmartTube/releases/) 上找到所有版本和更新日志。

最新测试版下载 (https://github.com/yuliskov/SmartTube/releases/download/latest/smarttube_beta.apk)

最新稳定版下载 (https://github.com/yuliskov/SmartTube/releases/download/latest/smarttube_stable.apk)

安装（带 Google TV 的 Chromecast）

在带 Google TV 的 Chromecast 上，默认会阻止应用安装，因此需要额外步骤：

4.1. 启用开发者选项

在您的 Chromecast 上，打开侧边菜单并进入 设置 > 系统 > 关于。滚动到 _Android TV 操作系统版本_部分并反复点击。会出现一条提示消息，说明您距离成为开发者还有几步。继续点击直到触发它。

4.2. 启用“未知来源”设置

返回主 设置 页面，选择 应用 > 安全与限制 > 未知来源。为 [_AFTVnews Downloader 或] 您决定使用的文件浏览器打开开关 […]。

[来源与图片指南 (https://www.androidpolice.com/2021/02/07/how-to-sideload-any-apk-on-the-chromecast-with-android-tv/#install-the-apk)]

之后，您可以按照上面的通用安装指南进行操作。

安装（使用中文固件的小米设备）

小米的中文固件可能会阻止测试版的安装。国际固件不受影响。

解决方案：

1. 改用 SmartTube 的稳定版（推荐）
2. 使用您设备的国际固件
3. （如果您的设备是 2020 年或更早的型号）您可以进行出厂重置，然后在系统更新之前安装 SmartTube 测试版。之后您可以安全地更新系统，SmartTube 应该能继续工作。

更新

应用内置更新器。您只需一次按照安装步骤操作即可。启动 SmartTube 几秒钟后，如果有任何更新，它会通知您并显示更新日志。您可以在“关于”设置中禁用自动更新检查或手动更新。

如果更新失败，可能是您的磁盘空间已满或更新下载不正确；请清理空间并尝试重新更新（设置 > 关于 > 检查更新）。

兼容性

SmartTube 需要 Android 4.3 或更高版本。它在非 Android 设备（包括 LG 或三星电视）上无法工作。在不支持的电视上，您可以使用电视棒或电视盒。

虽然该应用技术上能在智能手机和平板电脑上运行，但它并未针对这些设备进行优化，也不提供官方支持！它已在基于 Android 的电视、电视盒和电视棒上成功测试，包括：

• Android TV 和 Google TV（如飞利浦、索尼）
• 带 Google TV 的 Chromecast 及内置 Chromecast 的电视
• Amazon FireTV Stick（所有型号）
• NVIDIA Shield
• 运行 Android 的电视盒（许多廉价的中国无牌盒子）
• 小米 Mi Box

功能

界面

SmartTube 专注于为观看媒体内容提供简洁无干扰的界面。该应用不包含广告 UI 元素，专注于播放和浏览体验。

SponsorBlock

SmartTube 包含可选的 SponsorBlock 集成。来自 SponsorBlock 网站 (https://sponsor.ajay.app/)：

SponsorBlock 是一个开源的众包浏览器扩展和开放 API，用于跳过 YouTube 视频中的赞助商片段。[…] 该扩展使用一个保护隐私的查询系统自动跳过它已知的赞助商。它还支持跳过其他类别，例如片头、片尾和订阅提醒[以及音乐视频中的非音乐部分]。您可以在设置中选择要跳过的类别。

与浏览器插件不同，在 SmartTube 中您无法提交新的片段（电视和电视遥控器不是此类精确操作的良好设备）。请注意，SponsorBlock 是一个基于用户提交的免费且自愿的项目，因此不要期望它每次都能 100% 有效。有时，赞助商片段尚未提交到数据库，有时 SponsorBlock 服务器离线/过载。

投射

要从您的手机（或其他设备）投射视频，您必须将该设备与您的电视链接。与原版 YouTube 应用不同，当您在同一 WiFi 网络中时，SmartTube 不会自动显示。

如何链接您的智能手机和电视：

1. 打开 SmartTube 并转到设置
2. 转到“遥控”（第二个选项）
3. 在手机上打开 YouTube 应用，转到设置 > 常规 > 在电视上观看
4. 点击 使用电视代码连接 并输入您电视上显示的代码

截图指南 (https://t.me/SmartTubeEN/8514)

由于技术限制，您需要在投射前打开电视上的应用；SmartTube 无法自动唤醒电视。

画中画 (PiP)

SmartTube 支持在画中画模式下播放视频。这需要在 设置 > 常规 > 后台播放 > 画中画 下启用。当您在播放视频时按下主页键，以及在 设置 > 常规 > 后台播放（激活） 中启用后按下 返回 键时，视频将进入画中画模式。

调节速度

您可以通过按播放器顶行的速度指示器图标（仪表）来调节播放速度。这会在视频之间保留。某些速度可能会导致掉帧，这是一个已知问题。

语音搜索

要启用全局语音搜索，必须与 SmartTube 一起安装一个额外的应用。这个 桥接应用 允许系统语音搜索打开 SmartTube 而不是默认的 YouTube 应用。为此，您必须卸载原版 YouTube 应用。我们知道这很糟糕，但如果您改变主意，可以随时重新安装它。桥接应用 不会出现在您的启动器中，您也不能直接启动它；它仅供系统语音搜索内部使用。在某些设备上，您需要在搜索时明确说出“Youtube”（例如说“youtube 可爱的猫咪”，而不是只说“可爱的猫咪”）。

在 Amazon Fire TV 上：

1. 卸载原版 YouTube 应用（无需 root）
2. 下载并安装 Amazon Bridge SmartTube 应用：https://kutt.to/stn_bridge_amazon（例如通过 AFTVnews Downloader）

在带 Google TV 的 Google Chromecast 上：

1. 卸载原版 YouTube 应用（无需 root）
2. 下载并安装 ATV Bridge SmartTube 应用：https://kutt.to/stn_bridge_atv（例如通过 AFTVnews Downloader）

在所有其他 Android 设备上，遗憾的是需要 root 才能启用此功能：

1. 获取您设备的 root 权限（搜索您特定设备的指南）
2. 使用 root 卸载官方 YouTube 应用 (adb shell pm uninstall com.google.android.youtube.tv)
3. 下载并安装 ATV Bridge SmartTube 应用：https://kutt.to/stn_bridge_atv（例如通过 AFTVnews Downloader）

捐赠

如果您想支持我的开发工作，欢迎请我喝杯咖啡 :)

• Patreon（Visa、Mastercard、PayPal） (https://www.patreon.com/smarttube)
• PayPal: [email protected]
• BTC: 1JAT5VVWarVBkpVbNDn8UA8HXNdrukuBSx
• LTC: ltc1qgc24eq9jl9cq78qnd5jpqhemkajg9vudwyd8pw
• ETH: 0xe455E21a085ae195a097cd4F456051A9916A5064
• ETC: 0x209eCd33Fa61fA92167595eB3Aea92EE1905c815
• TRX: TJNPY794aSGZf3WGHTna2VCWm2G5Yua7E8
• USDT (TRC20): TJNPY794aSGZf3WGHTna2VCWm2G5Yua7E8
• USDT (BEP20): 0x64B28da787BE6ac5889D276A5638d4f077840eC5
• USDT (ERC20): 0xe455e21a085ae195a097cd4f456051a9916a5064
• TON: UQAc9zgnnzwS8yb5wxAu5CB0RddmjPBjWI-n46oQ7XfCQrgI
• XMR: 48QsMjqfkeW54vkgKyRnjodtYxdmLk6HXfTWPSZoaFPEDpoHDwFUciGCe1QC9VAeGrgGw4PKNAksX9RW7myFqYJQDN5cHGT

支持

请先查看 常见问题！ 也请至少快速浏览一下最近的聊天记录。您可以在我们的 Telegram 群组或通过 GitHub 问题跟踪器 (https://github.com/yuliskov/SmartTube/issues)（需要账号）进行报告。

• Telegram 群组（国际）: @SmartTubeEN (http://t.me/SmartTubeEN)
• Discord 群组（国际）: SmartTube Official (https://discord.gg/Wt8HDDej5z)
• Telegram 群组（俄语/乌克兰语）: @SmartTubeUA (http://t.me/SmartTubeUA)
• 邮箱: [email protected]

国际群组仅使用英语。但请不要担心您的英语是否完美，我们有一个友好的国际社区。

团队

SmartTube 是单人开发的；其背后没有更大的团队或公司。这是一个开源的业余项目。其他几个人协助了翻译工作，其中一些可以在 GitHub (https://github.com/yuliskov/SmartTube/graphs/contributors) 上看到，有些直接将翻译发送给了 Yurii。支持聊天中也有乐于助人的人。

构建

注意：需要 OpenJDK 14 或更早版本 (!)。较新的 JDK 可能导致应用崩溃！

要构建并安装调试版本，请运行以下命令：

git clone https://github.com/yuliskov/SmartTube.git
cd SmartTube
git submodule update --init
adb connect
gradlew clean installStstableDebug

视频编解码器

视频编解码器是用于视频压缩的算法。

应该选择哪种编解码器 / 概览

• 示例取自该视频 1080p @ 25fps 的纯视频轨道：Dua Lipa - New Rules (Official Music Video) (https://youtube.com/watch?v=k2qgadSvNyU)

在相同分辨率下，较低的比特率更好！ YouTube 会根据编解码器明确提供相同质量的内容。较旧的编解码器比特率更高只是因为它们效率较低。在 YouTube 上，您不会通过简单选择更高的比特率获得更好的质量。较新的编解码器具有更好的压缩率 = 更低的比特率 = 使用更少的带宽 = 节约环境资源。这是一个功能，而不是缺陷。您应该使用能在设备上流畅运行的最小编解码器，而不是效率最低的那个。AVC 通常具有最高的比特率。这很糟糕，并不好。

应该选择哪种质量？

目前，没有基于您的带宽的自动模式。但您可以在设置 > 视频播放器 > 视频预设下自行配置默认视频预设。第一个选项（“无”）将在视频播放器内记住您的上次选择。任何其他预设最初用于每个视频；如果所选配置文件不可用，则使用下一个最佳可用选项。您仍然可以…