# Spotube — Open Source Music Streaming Client

> A free, cross-platform music streaming client built with Flutter that uses Spotify metadata and YouTube as the audio source, requiring no premium subscription.

## Install

Save as a script file and run:

# Spotube — Open Source Music Streaming Client

## Quick Use
```bash
# Install via Flathub (Linux)
flatpak install com.github.KRTirtho.Spotube

# Or download from GitHub Releases for Windows/macOS/Android/iOS
# https://github.com/KRTirtho/spotube/releases
```

## 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/

---
Source: https://tokrepo.com/en/workflows/spotube-open-source-music-streaming-client-3540c482
Author: Script Depot