A lightweight, native YouTube Music app for Windows, Mac and iPhone with a pixel-faithful Spotify-style interface — plus a glossy Frutiger Aero / Windows 7 theme and an Apple Music theme.
It is not a wrapped music.youtube.com tab: the UI is a small (~90 KB gzipped)
Svelte app rendered by the system WebView2, talking directly to YouTube Music's
InnerTube API through a tiny Rust backend. Audio streams straight from Google's
CDN into a single <audio>/<video> element.
Grab the latest build from the Releases page:
| File | What it is |
|---|---|
SpotiTube-x.y.z-setup.exe |
Installer (per-user, no admin needed) — recommended |
SpotiTube-x.y.z-portable.exe |
Single executable, nothing to install |
SpotiTube-x.y.z.msi |
MSI package |
Windows 10/11. Uses the Microsoft Edge WebView2 runtime that ships with Windows.
| File | What it is |
|---|---|
SpotiTube-x.y.z-macos.dmg |
Universal app (Apple Silicon + Intel): open it and drag SpotiTube to Applications |
SpotiTube-x.y.z-macos.zip |
The same app zipped (used by the in-app updater) |
macOS 11 or later. Uses the system's WebKit, so it adds no browser engine of its own,
plays AAC streams through the hardware decoder, and shows up in the menu bar /
Control Center Now Playing with the keyboard media keys and AirPods controls.
The app isn't notarized: the first time, open System Settings → Privacy & Security
and click Open Anyway (or run xattr -dr com.apple.quarantine /Applications/SpotiTube.app).
| File | What it is |
|---|---|
SpotiTube-x.y.z.ipa |
Unsigned IPA: sideload it with AltStore / SideStore, Sideloadly or similar (they sign it with your Apple ID) |
SpotiTube-x.y.z-TrollStore.tipa |
For TrollStore; also carries the CarPlay entitlement |
iOS 16 or later. The iPhone app has its own phone layouts for all three themes (Spotify for iPhone, Apple Music on iOS, and a glossy Aero phone UI) and the same YouTube Music features as the desktop app, with native playback:
- Plays in the background and with the screen locked; lock screen, Control Center, headphone and AirPods controls
- The next song is queued natively in advance, so playback keeps going while the app is asleep
- AirPlay / Bluetooth output picker, sleep timer, Song ⇄ Video switch with native video
- CarPlay: SpotiTube always shows up in CarPlay's Now Playing with play/pause, skip, seek, shuffle and repeat.
Its own CarPlay app (Home, Library, Recents, Up Next) appears when the app is signed with Apple's
carplay-audioentitlement — the TrollStore build has it; a free/personal Apple ID signature can't include it. - Updates: Settings → Updates checks GitHub and downloads the newest IPA for your sideloading app
YouTube Music
- Sign in with your Google account (built-in sign-in window, or paste browser cookies as a fallback); brand-account / multi-account switching
- Home feed with mood chips, Explore, New releases, Charts (every region), Moods & genres
- Search with suggestions, search history, "did you mean", and filters (songs, videos, albums, artists, community/featured playlists, podcasts, episodes, profiles)
- Artist pages (popular songs, albums, singles & EPs, videos, featured on, playlists, related artists, about), subscribe/unsubscribe, artist radio & shuffle
- Albums, playlists (incl. collaborative and chart playlists), podcasts and episodes
- Library: playlists, songs, albums, artists, subscriptions, podcasts, channels, Liked Music, Episodes for later, listening history, uploads (upload & delete your own files)
- Like / dislike, save to library, pin to Listen again, remove from history
- Create, edit, copy and delete playlists; add/remove songs; "add anyway" duplicate handling
- Up next queue with radio / autoplay, mixes, start radio from anything, song ⇄ video toggle
- Time-synced lyrics (YouTube Music, with LRCLIB fallback), related tab, song credits
- Plays are recorded to your YouTube Music history
- Volume normalization (YouTube loudness data), audio quality selection, Premium mode
Player
- Spotify-style now-playing bar, queue, now-playing panel, lyrics panel, full-screen player, mini player (always-on-top, YouTube-style auto-hiding controls, and a spinning vinyl mode that floats on your desktop)
- Shuffle / repeat / repeat one, sleep timer, podcast playback speed
- Windows media controls (SMTC) + keyboard media keys, keyboard shortcuts
- Remembers your queue and position between launches
Discord
- Rich presence: "Listening to …" with song, artist, album art, a live progress bar and a "Play on YouTube Music" button; choose whether the status shows the app name, artist or song; optional custom Discord application ID
Spotify
- Link your Spotify account (Settings → Spotify): your profile page (avatar menu → Profile & friends) shows your YouTube Music and Spotify accounts side by side, your Spotify playlists, and the people you follow; everything is labelled with where it comes from
- Open any Spotify profile (from your friends, people you follow, or a pasted profile link) and browse its public playlists
- Play any Spotify playlist: each song is matched to YouTube Music by title, artist and length as it comes up; Copy to YouTube Music turns a Spotify playlist into a YouTube Music playlist
- Friend activity (experimental): see what your Spotify friends are listening to right now and play it. Spotify doesn't offer this to apps, so it uses a Spotify web player session; it can stop working if Spotify changes things
- Linking uses your own free Spotify developer app: create one at developer.spotify.com/dashboard, add the redirect URI
http://127.0.0.1:43821/callback, tick Web API, and paste its Client ID into Settings
Updates
- Built-in updater: checks GitHub Releases, shows an Update button when a new version exists, downloads it, verifies its SHA-256 and installs it in place (installer, MSI or portable exe), then reopens SpotiTube
Themes
- Spotify (default) — a faithful clone of the Spotify desktop UI
- Frutiger Aero — its own Windows Media Player 12-style layout: Aero glass caption with an Explorer breadcrumb bar, navigation tree, Now Playing list pane, and the glossy orb transport strip; three wallpapers (Aurora, Bliss-style sky, Aqua bubbles)
- Apple Music — the macOS Music / Apple Music for Windows layout: translucent sidebar with search, LCD now-playing display in the toolbar, Playing Next / History and full lyrics panels, red Play/Shuffle buttons; light, dark or automatic appearance
- Global accent color with a color wheel — both themes follow it (want red instead of Spotify green? one click)
| Keys | Action |
|---|---|
| Space | Play / pause |
| Ctrl + → / ← | Next / previous |
| Shift + → / ← | Seek ±5 s |
| Ctrl + ↑ / ↓ | Volume |
| Ctrl + S / Ctrl + R | Shuffle / repeat |
| Ctrl + K | Search |
| Alt + ← / → | Back / forward |
- Tauri 2 (Rust) instead of Electron: no bundled Chromium, ~5 MB installer
- One WebView, one media element; no hidden YouTube page running in the background
- Long lists are virtualized, images are lazy-loaded at the size they're shown
- The signature/"n" challenge solver (yt-dlp's EJS solver) only runs when the direct (JS-less) stream client fails, inside a worker that is terminated after use
npm ci
npx tauri build # Windows: produces exe, NSIS setup and MSI
npx tauri build --target universal-apple-darwin # Mac: .app and .dmg
npx tauri dev # developmentRequires Node 20+ and Rust (stable). The GitHub Actions workflow in
.github/workflows/build.yml builds the Windows and Mac releases automatically.
iPhone (macOS + Xcode 16):
npm ci && npm run build
cp -R dist ios/SpotiTube/web
cd ios && xcodegen generate && open SpotiTube.xcodeprojThe iOS app is a small Swift shell (ios/SpotiTube): it hosts the same web UI,
answers its commands natively (network with the Google session, sign-in sheets,
Spotify), plays audio with AVPlayer and drives CarPlay. CI builds the IPA and runs
the app in the iPhone simulator on every push.
- API structure ported from ytmusicapi (MIT)
- Stream challenge solver: yt-dlp/ejs (Unlicense)
- Lyrics fallback: LRCLIB
SpotiTube is not affiliated with Google, YouTube or Spotify.