Spotube — Open Source Music Streaming Client

Introduction

Spotube is a free, open-source music streaming client that pairs Spotify's catalog metadata with YouTube as the audio backend. It gives users access to Spotify playlists, albums, and recommendations without requiring a Spotify Premium subscription or injecting ads.

What Spotube Does

• Streams music using Spotify metadata and YouTube audio sources
• Syncs playlists, liked songs, and albums from your Spotify account
• Provides lyrics display synchronized to playback
• Runs natively on Windows, macOS, Linux, Android, and iOS via Flutter
• Supports offline downloads for local playback without internet

Architecture Overview

Spotube is built with Dart and the Flutter framework for cross-platform native performance. It authenticates against the Spotify Web API to fetch track metadata, playlists, and recommendations, then resolves audio streams from YouTube or Piped instances. The app uses a local SQLite database for caching and offline storage.

Self-Hosting & Configuration

• No server required; Spotube is a standalone desktop/mobile application
• Authenticate with your existing Spotify account (free tier works)
• Configure a custom Piped instance for YouTube audio resolution if desired
• Set download quality and storage location in app preferences
• Supports system proxy settings for restricted networks

Key Features

• Zero ads and no premium subscription needed for full playback
• Cross-platform Flutter app with consistent UI across all devices
• Spotify algorithm-powered recommendations and radio
• Built-in lyrics with time-synced display
• Lightweight resource usage compared to Electron-based alternatives

Comparison with Similar Tools

• Spotify Desktop — requires Premium for ad-free listening and offline mode
• Nuclear — similar concept but Electron-based and heavier on resources
• YouTube Music — ad-supported unless subscribed, no Spotify playlist sync
• Cider — Apple Music client, different ecosystem entirely
• BlackHole — mobile-only, focuses on Indian music catalog

FAQ

Q: Do I need a Spotify Premium account? A: No. Spotube works with a free Spotify account since audio comes from YouTube, not Spotify servers.

Q: Is Spotube legal to use? A: Spotube uses publicly available APIs. Users should review their local laws regarding stream sourcing.

Q: Does it support offline playback? A: Yes. You can download tracks locally for offline listening.

Q: Which platforms are supported? A: Windows, macOS, Linux (Flatpak/AppImage), Android, and iOS.

Sources

• https://github.com/KRTirtho/spotube
• https://spotube.cc/