SmartTube
Browse media content with your own rules on Android TV
Install / Use
/learn @yuliskov/SmartTubeREADME
Important announcement about the app
My development environment was infected by unknown malicious software, as a result of which a few builds may have been affected. Once the issue was detected, I secured everything with a full disk wipe, restored a clean setup, and now all builds are scanned with VirusTotal. The F-Droid version will also be verified before release.
Public keys may have been compromised, which is why I am sharing this issue. You can download the new version and the new public key below, and instructions for restoring backups are provided.
No extra actions are required since the app uses one-time connection codes. These codes have very limited permissions (for example, they cannot change your password). Still, you can revoke them if you want full peace of mind.
How to revoke access:
- Open myaccount.google.com/security
- Find “Your connections to third-party apps & services”
- Tap “See all connection” and locate YouTube TV or Google Drive
- Select the app → “Remove access”
Please keep built-in security features enabled to stay protected.
SmartTube
<!-- <img width="100" src="https://github.com/yuliskov/SmartTube/blob/master/smarttubetv/src/ststable/res/mipmap-nodpi/app_icon.png" alt="logo"/> -->
SmartTube is a free and open-source advanced media player for Android TVs and TV boxes. It allows you to play content from various public sources.
✅ Features
- No ads
- SponsorBlock integration
- Adjustable playback speed
- 8K resolution support
- 60fps playback
- HDR compatibility
- View live chat
- Customizable buttons
- Does not require Google Services
- Helpful international community
❌ Limitations
- Not supported on phones and tablets
- Comment functionality is unstable
- Voice search and casting performance may be inferior to official apps, depending on your device
Give it a try!
Do you have any question? Ctrl+F or ⌘F this readme first!
Installation | Official Site | Donation | FAQ | Support / Chat | Build | Translate the app | Changelog | Liability
Device support
[!IMPORTANT]
Starting in October 2025 new Amazon FireTV devices no longer run Android under the hood. SmartTube will not be compatibile with the Fire Stick 4k Select and newer devices which run Amazon's own VegaOS.

- Supported: all Android TVs and TV boxes (incl. All FireTV devices released before Oct. 2025, NVIDIA Shield & Chromecast with Google TV), even older ones with Android 4.3 (Kitkat).
- Not supported: Smartphones, non-Android platforms like Samsung Tizen, LG webOS, Apple TV, etc.
Installation
video of the installation (note: download url changed to
kutt.to/stn_betaorkutt.to/stn_stable)
Do not download SmartTube from any app store, APK websites or blogs; these were uploaded by other people and may contain malware or ads. SmartTube is not officially published on any app store. Sadly, the Google PlayStore does not allow ad-free Youtube apps using unofficial APIs.
There is a beta release (recommended) and a stable release. Beta gets new features and bugfixes faster than the stable release.
You can use either of the following methods to install the app:
- (Easiest) Install Downloader by AFTVnews on your Android TV, open it and enter
kutt.to/stn_betaorkutt.to/stn_stable, then read, understand and confirm the security prompts. (<small>You can also enter 79015 (for beta) or 28544 (for stable), but this requires an extra step to install the AFTVnews Downloader browser addon if you haven't already.</small>) - Install a file transfer app on your Android TV, download the APK on your phone or computer and transfer it to your TV (e.g. Send Files to TV from the Google Play Store / Amazon AppStore)
- Download the APK onto a USB stick, put the USB stick into your TV and use a file manager app from the Google Play Store / Amazon AppStore (e.g. FX File Explorer or X-plore). Android's preinstalled file manager does not work! Do not get the ad-infested FileCommander.
- If you are an advanced user, you can install it using ADB. guide | alternative guide
Troubleshooting: See device specific notes below. If installation fails, either your disk space is full or the APK file didn't download correctly; clear up space and try downloading again. If the app installed, but crashes when opening, make sure to install it to internal memory, not to an SD card / external storage.
The app has a built-in updater with changelog. You can also find all releases and the changelog on the Telegram channel @SmartTubeNewsEN (readable without account) or on Github.
latest beta download
latest stable download
Installation (Chromecast with Google TV)
On Chromecast with Google TV, installation of apps is blocked by default, so an extra step is required:
4.1. Enable Developer Options
On your Chromecast, open the side menu and go to Settings > System > About. Scroll down to the Android TV OS build section and click that repeatedly. A toast message will appear, explaining that you are a few steps away from being a developer. Continue clicking until you trigger it.
4.2. Turn on the "unknown sources" setting
Go back to the main Settings page and select Apps > Security & Restrictions > Unknown sources. Turn on the toggle for [Downloader by AFTVnews or] whichever file browser you decided to use [...].
After this, you can follow the general installation guide above.
Installation (Xiaomi devices with Chinese firmware)
Xiaomi's Chinese firmware might block the installation of the beta version. The international firmware is not affected. Solutions:
- Use SmartTube's stable version instead (recommended)
- Use the international firmware for your device
- (if your device is from 2020 or before) You can do a factory reset and then install SmartTube beta before doing any system updates. You can then safely update your system, SmartTube should continue working.
Updating
The app has a built-in updater. You only need to follow the installation procedure once. A few seconds after launching SmartTube, it will notify you if there is any update and also show a changelog. You can disable automatic update checks or manually update in the settings under "about".
If the installation fails, either your disk space is full or the update didn't download correctly; clear up space and try updating again (Settings > About > Check for updates).
Compatibility
SmartTube requires Android 4.3 or above. It does not work on non-Android devices (incl. LG or Samsung TVs). On unsupported TVs, you can use a TV stick or TV box. Though this app technically runs on smartphones and tablets, it is not optimized for such and offers no official support!
It has been successfully tested on TVs, TV boxes and TV sticks that are based on Android, including:
- Android TVs & Google TVs (e.g. Philips, Sony)
- Chromecast with Google TV & TVs with Chromecast built-in
- Amazon FireTV stick (all generations)
- NVIDIA Shield
- TV boxes running Android (many cheap chinese no-name boxes)
- Xiaomi Mi Box
Features
Adblocking
SmartTube does not show any ad banners, preroll ads or ad intermissions. It not just tries to prevent them, it is literally programmed to be completely unable to display any ads, so YouTube cannot slip anything in. This also means you cannot allow ads or whitelist channels. Some YouTube channels include sponsored messages in their videos, these can also be skipped, see SponsorBlock below.
SponsorBlock
SmartTube includes a SponsorBlock integration. From the SponsorBlock website:
SponsorBlock is an open-source crowdsourced browser extension and open API for skipping sponsor segments in YouTube videos. [...] the extension automatically skips sponsors it knows about using a privacy preserving query system. It also supports skipping other categories, such as intros, outros and reminders to subscribe [and non-music parts in music videos].
You can select which categories you want to skip in the settings. Unlike the browser addon, in SmartTube you cannot submit new segments (TVs and TV remotes aren't great devices for such precise operations). Note that SponsorBlock is a fre
Related Skills
docs-writer
98.6k`docs-writer` skill instructions As an expert technical writer and editor for the Gemini CLI project, you produce accurate, clear, and consistent documentation. When asked to write, edit, or revie
model-usage
329.0kUse CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
arscontexta
2.8kClaude Code plugin that generates individualized knowledge systems from conversation. You describe how you think and work, have a conversation and get a complete second brain as markdown files you own.
be
Assume the personality of the Persona described in any of the document available in the @~/.ai/personas directory.
