Black Candy is a self-hosted music streaming server that lets you run your own personal music center.
The tool solves the problem of streaming your music collection without relying on commercial services. It works by accepting mounted media files from your host system, scanning them for playback, and serving them through a web interface. The server uses SQLite as its default database for simplicity in self-hosted deployments, though PostgreSQL is available as an alternative for larger installations or cloud hosting scenarios.
Black Candy suits anyone wanting to stream their own music library privately without external dependencies. It works well for small to medium self-hosted setups where SQLite's simplicity is an advantage, and scales to larger deployments through PostgreSQL support. The project provides Docker-based installation to minimize setup friction. Mobile apps are available for iOS, Android, and F-Droid, extending access beyond the web interface. A demo instance is available for evaluation before deployment.
The project maintains active continuous integration with automated testing. Code coverage is tracked and publicly reported. Docker image distribution is actively used, indicating regular releases and container-based deployment focus. The maintainers emphasize careful upgrade procedures, documenting breaking changes in upgrade guides to help users navigate version transitions safely.
