Spooty

Self-Hosted

Open-source self-hosted client for local media and Spotify streaming

Overview

Spooty is an open-source, self-hosted media client that unifies local music libraries with Spotify streaming. It features a clean interface for browsing, searching, and managing playlists across both sources. Deployable via Docker for quick setup, it supports MP3, FLAC, WAV, and integrates with Spotify API (optional) for streaming access. Users retain full data control with self-hosting, plus offline playback for local files and cross-device access via its web-based interface. Ideal for music enthusiasts seeking privacy and flexible media management.

Self-Hosting Resources

Find Official Image on Docker Hub View Source & Docs

Below is a reference structure for docker-compose.yml. ⚠️ Do NOT run blindly. Replace placeholders with official values.

docker-compose.template.yml TEMPLATE


version: '3'
services:
  spooty:
    image: <OFFICIAL_IMAGE_NAME>:latest
    container_name: spooty
    ports:
      - "8080:<APP_INTERNAL_PORT>"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Key Features

Unifies local media libraries with Spotify streaming
Docker-powered easy self-hosting setup
Supports common audio formats (MP3, FLAC, WAV)
Web-based interface for cross-device access

Frequently Asked Questions

? Is Spooty hard to install?

No—Spooty uses Docker for simplified deployment. The official repo provides a docker-compose file and step-by-step instructions to launch it in minutes, including optional Spotify API setup.

? Is it a good alternative to the official Spotify client?

Yes, for users prioritizing privacy and local media integration. It offers core music playback/playlist features but lacks advanced tools like podcasts. Ideal for self-hosting enthusiasts who want control over their media data.

? Is it completely free?

Yes—Spooty is open-source under the MIT License, so it’s free to use, modify, and self-host. However, Spotify streaming access requires a free/premium Spotify account (separate from Spooty).

Top Alternatives

Spotify Official Client Search Google

Apple Music Search Google

Tidal Search Google

Tool Info

Pricing Open Source

Category Media Management

Platform Self-Hosted

Pros

⊕ Privacy-focused (no third-party data collection)
⊕ Free and open-source (MIT License)
⊕ Seamless local + streaming content integration
⊕ Minimal technical expertise needed for deployment

Cons

⊖ Requires Spotify API key for streaming integration
⊖ Limited mobile app support (primarily web-based)
⊖ Lacks advanced Spotify features (podcasts, radio)
⊖ Occasional sync delays with Spotify playlists