smarttube-phone

Introduction: StreamTube: ad-free YouTube for Android phones. A port of SmartTube with a touch UI, in-app mini player, Shorts, comments and downloads.
More: Author   ReportBugs   
Tags:

StreamTube

Ad-free YouTube for Android phones.
A touch app that looks and feels like the official one: portrait player, an in-app mini player, instant swipeable Shorts,
a music player with lyrics, comments you can write and delete, downloads, background play, SponsorBlock, and Dark or Light appearance.

Download the latest APK  ·  All releases  ·  How to install

Home Player Mini player over Home Shorts

The Music page The music player Lyrics in the music player The music bar

[!NOTE] StreamTube is a port of SmartTube to Android phones. SmartTube, by Yuriy Liskov, is the popular open-source YouTube client for Android TV, made for the big screen and a TV remote. StreamTube keeps SmartTube's engine (the YouTube client, playback, sign in, SponsorBlock and settings) and replaces the TV interface with a touch interface built for phones. It is an independent project, not affiliated with SmartTube's developer, YouTube or Google. For the TV app, visit the SmartTube repository.



Features

Feels like YouTube

  • Bottom tabs: Home, Shorts, Subscriptions and You
  • Topic chips on Home (Kids, Sports, LIVE, Gaming, News and more)
  • Full-width video cards with channel pictures, and horizontal shelves
  • Videos open with a smooth expand-from-thumbnail animation

Player

  • Portrait player: the video on top, then the title, channel, buttons, comments and recommendations
  • Like, dislike, subscribe, share, download, save to a playlist, captions, quality and playback speed
  • Rotate the phone (or tap the full screen button) for full screen, with gestures for seeking, brightness, volume and zoom
  • Videos start quickly: 1080p by default on phones, and nothing extra is loaded before the first frame

Mini player

  • Swipe the video down, or press Back: it shrinks into a small player at the bottom right of the screen and keeps playing while you browse Home, Search or a channel
  • Drag it anywhere, tap it to go back to the full player, close it with X
  • Background play with media controls in the notification and on the lock screen

Comments

  • Total count, Top or Newest first, and reply threads
  • Write comments and replies when signed in
  • Long press your own comment or reply to delete it

Downloads

  • Save a video from 1080p down to 360p (MP4), or audio only (M4A), to Download/StreamTube

Shorts

  • Full screen vertical Shorts that start the instant you swipe: the next one is already loaded while you watch
  • Swipe up for the next one, down for the previous one; a Short that ends moves on to the next by itself
  • Like, dislike, comments, share and save on the right side, like the official app

Music

  • A Music page, second on Home: featured music videos you swipe through, Play and Shuffle, playlists with their artwork and number of tracks, and the top charts
  • Playlists like YouTube's: big artwork, title and description, Play all, Shuffle and Share
  • A music player made for listening: big artwork (swipe it for the next song), a background that glows in the song's colours as it plays, shuffle, repeat and like
  • Lyrics in time with the song: the line being sung under the title; tap it to see all the lyrics in place of the artwork, tap a line to jump there
  • A music bar at the bottom of the app when you go small: artwork, title, play with the song's progress around it, and next
  • Search for music: a music switch in Search (and a search button on the Music page) opens the songs and playlists you find in the music player; Listen under any video switches it to the music player

No ads, and more

  • No ads, and no tracking added by the app
  • SponsorBlock skips sponsor segments, intros, outros and reminders to subscribe
  • Up to 8K, 60 fps and HDR when your phone supports it
  • Works without Google Play services
  • Dark (pure black for AMOLED screens), Light, or Same as device
  • Built-in updater: see what's new and install new builds from inside the app; after each update, a What's new card shows once on Home
  • A small download (about 29 MB)

Requirements

  • An Android phone with Android 8.0 or newer (the in-app mini player needs Android 11 or newer; older versions use a floating window instead)
  • An ARM processor, 64-bit or 32-bit. Pick the APK for your phone:
APK For
StreamTube-arm64 Almost every phone made since 2017, including all recent Samsung, Pixel, OnePlus, Xiaomi and Motorola phones. Start with this one.
StreamTube-arm32 Older or budget phones with a 32-bit processor (armeabi-v7a), where the arm64 APK says "App not installed".
StreamTube-universal Any device, including x86 emulators and Chromebooks. It's a bigger download.

Not sure? Install the universal APK. The in-app updater then picks the right APK for your phone.

It installs as its own app, so it can sit next to the official YouTube app without conflicts.

Install

  1. On your phone, open this link: StreamTube-arm64 (or the arm32 or universal APK, see Requirements)
  2. When the download finishes, tap the notification (or open the file from your Downloads folder).
  3. The first time, Android asks for permission to install apps from your browser. Tap Settings, turn on Allow from this source, then go back.
  4. Tap Install. If Google Play Protect warns about an unknown app, tap More details and then Install anyway. This warning appears for apps that don't come from the Play Store.
  5. Open StreamTube from your app drawer. Home shows popular videos straight away; you can sign in whenever you like.

When Android asks to allow notifications, tap Allow. StreamTube uses notifications only for the background playback controls (also shown on the lock screen) and, if you want, to tell you about new builds.

Update to a new build

Each build is listed on the releases page. The download link above always points to the newest one.

From inside the app (recommended)

  1. Open the You tab, tap Settings, then Check for updates. The Software update screen shows the build you have and checks right away.
  2. If a newer build exists, it shows Update available with the build number, the download size and a What's new list. Tap Download and install; a progress bar shows the download.
  3. The first time, Android asks you to allow StreamTube to install apps: tap Open settings, turn on Allow from this source and come back. The update carries on by itself.
  4. Android shows its usual confirmation. Tap Update. You stay signed in and your settings are kept.

With Notify me about new builds turned on (on the same screen), StreamTube checks every few hours and shows a small Update card on Home when a new build is out.

Manually

Download the latest APK from the link above and install it over the app you have. Android shows Update instead of Install.

On builds 39 to 51? Those builds can't update themselves. Install the latest APK manually once; it installs over your current app and keeps your settings.

Coming from build 38 or older? Those builds were signed with a temporary key, so Android refuses to install over them ("App not installed"). Uninstall the old app once (long press the icon, then Uninstall) and install the latest APK. Every update after that installs normally.

Connect your YouTube account

You don't need an account to watch. Signing in adds your own recommendations on Home, your subscriptions, history, playlists and Watch later, and lets you like, subscribe, save and comment.

StreamTube signs in the same way a smart TV does: the app shows a short code and you approve it on Google's own website. Your password is never typed into StreamTube and never passes through it.

The You tab before signing in The sign in screen with a code

On the same phone

  1. Open the You tab (bottom right) and tap Sign in. You can also tap Sign in on the card at the top of Home.
  2. Wait a moment until StreamTube shows your sign-in code.
  3. Tap Continue in browser. Google's device activation page (yt.be/activate) opens with the code filled in. If it isn't, tap the code in StreamTube to copy it and paste it on the page.
  4. Choose your Google account and tap Allow.
  5. Switch back to StreamTube. It signs you in by itself within a few seconds.

Using another device

  1. In StreamTube, open the You tab and tap Sign in.
  2. On a computer or another phone, go to yt.be/activate and enter the code shown in StreamTube.
  3. Pick your account and tap Allow. StreamTube signs in on its own.

More than one account

  • Add another account: You tab, Accounts, then add an account and repeat the steps above.
  • Switch accounts: You tab, Switch account.
  • Sign out or remove an account: You tab, Accounts.

To remove the app's access from your Google account, go to myaccount.google.com/permissions and remove the YouTube on TV entry.

How to use

Home

Home

  • Scroll the feed and tap any video to play it.
  • Tap a chip at the top (Kids, Sports, LIVE, Gaming, News) to switch topics.
  • Tap a channel picture to open that channel, or the three dots next to a video for more options.
  • Top right: search.

Watching a video

Player

  • Tap the video to show or hide the controls: play and pause, previous and next, playback speed, captions (CC), settings (quality and more) and full screen.
  • Seek by dragging the red progress bar, or double tap the left or right side to jump back or forward.
  • Below the video: the title, the channel with its Subscribe button, then Like, Dislike, Comments, Share, Download and Save. Scroll the row sideways for more.
  • Download: pick a quality from 1080p to 360p (MP4) or Audio only (M4A). It downloads in the background with a progress notification and is saved to Download/StreamTube. Live streams can't be downloaded.
  • Recommendations are listed under the buttons. Tap one to play it.
  • Leave the player: swipe the video down or press Back. It becomes the mini player and keeps playing.

Comments

Comments

  • Tap Comments under the video. The sheet shows the total count and a Top / Newest switch. Tap a comment's replies to read the thread.
  • Write: when signed in, type in the bar at the bottom and tap send. Your comment (or reply, inside a thread) appears on top right away.
  • Delete: long press one of your own comments or replies, then Delete.

Mini player and background play

The mini player at the bottom right of Home

  • Swipe the video down (or press Back): it shrinks into a small player at the bottom right of the screen you came from, and the video keeps playing while you browse Home, Search or a channel.
  • Drag the mini player anywhere; it settles against the nearest side. It always starts at the bottom right.
  • Tap it to open the full player again. X closes it; the small button pauses or plays.
  • Open another video while it plays: the new video opens in the full player.
  • Background play: press the home button or lock the screen while a video plays and the sound keeps going. The notification and the lock screen show play and pause controls. Shorts don't play in the background.

Full screen gestures

Rotate the phone sideways, or tap the full screen button. In full screen:

Gesture What it does
Tap Show or hide the controls
Double tap on the left or right Jump back or forward
Swipe up or down on the left half Brightness
Swipe up or down on the right half Volume
Pinch out Zoom the video to fill the screen
Pinch in Back to the original size

Rotate back to portrait, or press Back, to leave full screen.

Shorts

Shorts

  • Tap the Shorts tab: the first Short starts playing right away, full screen.
  • Swipe up for the next Short, swipe down for the previous one. Tap to pause or resume.
  • On the right: Like, Dislike, Comments, Share and Save. At the bottom: the channel (tap it to open the channel), Subscribe and the title.
  • Shorts start the moment you swipe: while you watch one, the next is already loaded and waiting.

Music

The Music page: featured music videos, Play and Shuffle, shelves The music player, glowing in the colours of the song's artwork The lyrics in place of the artwork The music bar at the bottom of the app

The Music page. Tap Music, the second chip on Home.

  • At the top, featured music videos: swipe sideways through them (they also move on by themselves), tap one to play it.
  • Play starts the hits, Shuffle a random one.
  • Below: playlists (artwork, description and number of tracks), the top charts, and shelves of songs.

Playlists. Tap a playlist for its page: the artwork big on top over its own colours, the title, description and number of videos, then Play all, Shuffle and Share, and the songs below.

The music player. Songs you open from Music play in a player made for listening:

  • The big artwork, with a background that glows in the song's colours and gently pulses while it plays.
  • Swipe the artwork left for the next song, right for the previous one (or use the buttons).
  • The seek bar, Shuffle, Previous, Play/Pause, Next and Repeat, and Like next to the title.
  • Video (top right) shows the video instead.

Song mode. Songs in the music player play the song itself, like YouTube Music's Song mode: no music video intros or scenes. Tap Video to watch the music video.

Lyrics. Under the title, a coloured line with little moving bars shows the words being sung. Tap it: the lyrics take the artwork's place, the current line lit up and scrolling with the song; tap any line to jump there, and tap the small artwork in the corner (or Back) to return.

  • In time with the song: the first choice is YouTube Music's own timed lyrics for the song playing, then Apple Music's (through BetterLyrics, lrc.red and LyricsPlus), SimpMusic and LRCLIB. All of them are asked at once, so the lyrics appear within a few seconds. Songs none of them know show no lyrics line.
  • In the song's language: a Hindi or Punjabi song shows its lyrics in Hindi (Devanagari) letters, or in Gurmukhi on a phone set to Punjabi, whichever script the source wrote them in. An English song stays in English.

A background that feels the song. Behind the player, a faint, slow animation follows the song's mood, read from its title and lyrics: hearts drifting up for a love song, soft rain for a sad one, sparkles for a party song, aurora waves for a calm one, rings pulsing for an energetic one and embers rising for a devotional one. It pauses with the song and stays still when the phone's animations are off.

Perfect by Ed Sheeran: its lyrics, hearts drifting up behind Perfect in the music player: the line being sung under the title, hearts drifting up behind

Fix You by Coldplay: its lyrics, the line being sung lit up, soft rain behind Fix You in the music player: the line being sung under the title, soft rain falling behind Party Rock Anthem by LMFAO: its lyrics, sparkles twinkling behind Party Rock Anthem in the music player, with sparkles behind

In the car. Car and Bluetooth screens show the title and artist of what's playing, with its artwork (in the music player, the song's own name and singer).

Search for music. In Search, turn on the music note next to the filters (it lights up red): songs and playlists from the results open in the music player, and it stays on until you turn it off. The search button on the Music page opens Search with it already on.

Listen to any video. Playing a video from anywhere else (Home, Subscriptions, a link)? Tap Listen under it to switch to the music player; the songs after it play there too.

Search with the music switch on A song from the search, in the music player Listen under a video The search button on the Music page

The music bar. Tap the down arrow at the top of the music player: it slides down into a bar at the bottom of the app with the artwork, title and artist, Play/Pause circled by the song's progress, and Next. Keep browsing while the music plays; tap the bar to open the player again, or swipe it away to stop.

Channels

Channel page

  • Tap a channel picture or name anywhere to open the channel: banner, picture, name, handle, subscriber and video counts, description and Subscribe.
  • Tabs switch between Videos, Shorts, Live, Playlists and the channel's other sections.

Search

Search suggestions Search results

  • Tap the magnifying glass at the top of Home, type to see live suggestions, or tap the microphone to search by voice.
  • Results include videos, channels and playlists.

Subscriptions and the You tab

  • Subscriptions shows the latest videos from the channels you follow (sign in first). On top, a row of your channels with a blue dot on the ones with new videos; tap a channel to see only its videos, tap it again to see all. The chips All, Today, Videos, Shorts and Live filter the feed.
  • You shows your account (Sign in, Switch account, Accounts), then History, Playlists (including Watch later and liked videos), My videos, Downloads and Settings. Each opens as a page of its own, with a back arrow to return to You.

Settings and appearance

Settings Home in Light appearance

Open the You tab and tap Settings (or the gear at the top of the You tab).

  • Appearance: tap it to cycle between Dark, Light and Same as device. The app switches immediately.
  • Notifications: shows whether notifications are on; tap it to allow them.
  • Check for updates: opens the Software update screen (see Update to a new build).
  • About: version, links and credits.
  • Below them, the full player and app settings: default quality, playback speed, captions style, autoplay, SponsorBlock segments, background playback, history, accounts and more.

Troubleshooting

"App not installed" when installing a new build You probably have one of the early builds signed with a temporary key. Uninstall it once, then install the latest APK. See Update to a new build.

Google Play Protect says "Harmful app blocked" Play Protect checks apps installed from outside the Play Store and sometimes flags open-source apps by mistake. StreamTube's source code is public in this repository, and every build is made and signed by GitHub Actions from that code. Tap Install anyway (on some phones under More details).

The sign-in code doesn't appear Check the connection, and turn off Private DNS, ad-blocking DNS or VPN apps that block YouTube or Google, then tap Try again.

"Sign in to confirm you're not a bot" YouTube sometimes asks this on shared or busy networks and with VPNs. Signing in usually fixes it; switching between Wi-Fi and mobile data can help too.

Videos buffer a lot Open the player settings and pick a lower quality (1080p is the default on phones), or turn off high frame rate.

No sound in the background, or no controls on the lock screen Turn on notifications (You, Settings, Notifications) and check your phone's battery settings. On OnePlus, Xiaomi, Samsung and similar phones, set StreamTube's battery usage to Unrestricted.

The app crashed When it opens again it offers a crash report. Please open an issue with the report and the steps that led to it.

Privacy

  • No ads, and no tracking added by the app.
  • Sign in happens on Google's website; the app never sees your password. It keeps only the access token Google gives it, on your phone.
  • The app talks to YouTube, to GitHub when it checks for updates, to SponsorBlock if it is turned on, and to lyrics services (YouTube Music, BetterLyrics, lrc.red, LyricsPlus, SimpMusic and LRCLIB) for the lyrics of songs you play in the music player (it sends the song's title, artist, length and video ID, nothing about you). See PRIVACY.md.

Building from source

StreamTube is the Gradle flavor stphone. The phone code lives in smarttubetv/src/stphone/.

Every push to main is built and released by GitHub Actions (.github/workflows/phone.yml), which also applies the phone changes to the MediaServiceCore submodule from .github/patches/. Pull requests are built and tried on an emulator first (.github/workflows/pr-check.yml). To build locally with JDK 17 and the Android SDK:

git clone --recursive https://github.com/shreyas-bangera/smarttube-phone.git
cd smarttube-phone && git -C MediaServiceCore apply --ignore-whitespace ../.github/patches/mediaservicecore.patch
./gradlew assembleStphoneRelease

Credits

StreamTube is a port of SmartTube by Yuriy Liskov and its contributors. Their engine (the YouTube client, sign in, playback, SponsorBlock and settings) runs underneath, with a phone interface on top. If you enjoy StreamTube, please star SmartTube too. Thanks also to SponsorBlock and ExoPlayer.

StreamTube is an independent project, not affiliated with YouTube or Google. Please report problems here.

License

MIT. See LICENSE.

Apps
About Me
GitHub: Trinea
Facebook: Dev Tools
AI Daily Digest