Black Candy Store logo
🍬 A fork of Black Candy — expanded with multi-library & cross-server features

Black Candy Store

Your personal music streaming server. Stream your collection from anywhere, share libraries across servers, and keep everything in sync — all self-hosted.

View on GitHub Documentation Get Started

Features

Everything Black Candy offers, plus powerful multi-library and sharing capabilities.

🎵

Stream Your Music

Browse, search, filter, and stream your entire collection from a clean web player. Supports AirPlay and Chromecast.

📚

Multiple Libraries Store

Organize your music into named libraries, each backed by its own media path. Switch between them on the fly.

🔗

Cross-Server Sharing Store

Share a library with someone on another Black Candy server using an invite code. Revoke access anytime.

🔄

Automatic Catalog Mirroring Store

Shared libraries are mirrored locally as metadata-only copies that stay in sync automatically. Browsing is fast, audio streams live.

🎚️

Source Preference Store

When a track exists in multiple libraries or servers, choose to prefer local copies or the highest-quality source.

📋

Playlists & Favorites

Build playlists, manage your playback queue, and favorite tracks. Your library, your way.

🔒

Built-in HTTPS

Automatic Let's Encrypt certificates. Set your domain, expose 443, done. No reverse proxy required.

🐳

Docker-First

Ships as a single Docker image. Run one command and you're streaming. Works with SQLite or PostgreSQL.

📡

DAAP & RSP Support

Expose your music to external media clients via DAAP and RSP protocols, each toggleable in settings.

Get Running in Seconds

One command. That's it.

docker run -p 80:80 ghcr.io/ajeskey/blackcandystore:latest