blackCandy
A self-hosted music streaming server that serves as your personal music center.
What is blackCandy?
Black Candy is a self-hosted music streaming server that allows users to host and stream their personal music collections. It provides a web interface and mobile apps for accessing music from anywhere, giving users complete control over their library without relying on commercial streaming services.
Music enthusiasts, homelab users, and developers who want to host their own music streaming service with privacy and customization in mind.
It offers a fully open-source, self-hosted alternative to commercial music streaming platforms, with easy Docker-based deployment, mobile app support, and the flexibility to use SQLite or PostgreSQL.
Overview
A self hosted music streaming server
Use Cases
Best For
- Hosting a personal music library accessible from multiple devices
- Creating a private music streaming service for family or small teams
- Learning about self-hosted media server deployment with Docker
- Integrating with Discogs for automatic music metadata enrichment
- Developing or contributing to open-source music streaming projects
- Setting up a music server with mobile app support (iOS/Android)
Not Ideal For
- Users who prefer a fully managed, cloud-based music service without server administration or Docker complexity
- Teams requiring real-time collaborative features like shared playlists, social sharing, or advanced music recommendations
- Production environments where seamless, zero-downtime upgrades are critical, due to potential breaking changes
- Developers seeking extensive third-party integrations or a large plugin ecosystem beyond basic Discogs support
Pros & Cons
Pros
Installation is a one-liner with Docker, as shown in the README with commands like 'docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest', making setup quick and accessible for self-hosting.
Official iOS and Android apps are available on App Store and F-Droid, providing dedicated mobile access for streaming on the go, which is rare for self-hosted solutions.
Supports both SQLite for simple setups and PostgreSQL for scalable or cloud-based deployments, offering adaptability to different hosting needs, as detailed in the configuration section.
Automatically fetches artist and album images using the Discogs API, enhancing library management without manual effort, as mentioned in the integrations part.
Cons
The README explicitly warns that upgrades may include breaking changes, requiring careful review of the upgrade guide and manual intervention, which can lead to data loss or downtime for users.
When mounting volumes, users must manually set UID and GID with the '--user' flag to avoid permission issues, adding unnecessary complexity to the setup process.
Beyond Discogs, there are few built-in integrations or plugins mentioned, restricting functionality and customization compared to more extensible alternatives like Funkwhale.
Open Source Alternative To
blackCandy is an open-source alternative to the following products:
Tidal is a music streaming service that offers high-fidelity audio quality, exclusive content, and music videos with a focus on artist compensation.
Apple Music is a music and audio streaming service by Apple offering access to millions of songs, curated playlists, radio stations, and integration across Apple devices.
Spotify is a digital music streaming service that gives users access to millions of songs, podcasts, and videos from artists around the world.
Frequently Asked Questions
Related Projects
maybeThe personal finance app for everyone
mastodonYour self-hosted, globally interconnected microblogging community
discourseA platform for community discussion. Free, open, simple.
chatwootOpen-source live-chat, email support, omni-channel desk. An alternative to Intercom, Zendesk, Salesforce Service Cloud etc. 🔥💬
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.