Black Candy logo

Black Candy

Self-hosted music streaming server, your personal music center

Alternative to: spotify, apple music, plex

Black Candy screenshot

About Versions (11)

v3.2.0

2026-05-07

Version 3.2.0 updates Ruby and Rails versions, adds volume control enhancements, and introduces minimum app version support.

v3.1.0

2025-06-18

This release introduces parallel media sync, upgrades Rails and wahwah, replaces Nginx with Thruster, and fixes volume permissions.

v3.0.0

2024-05-31

Black Candy v3 introduces official mobile apps and various improvements over v2.

v2.1.1

2022-08-09

Replaced PostCSS with Sass, added a dev container, and fixed issues with Docker Compose v2 and cookie persistence in non-HTTPS environments.

v2.1.0

2022-07-15

This release introduces a user authentication API, automatic media library synchronization, and upgrades Ruby to 3.1 along with various search and performance improvements.

v2.0.1

2022-01-17

Fixed an issue where the SECRET_KEY_BASE was not found on the worker.

v2.0.0

2021-12-31

This release introduces Media Session API support, a new search page, transcode settings, and upgrades Rails to 7.0 and Stimulus to 3.0.

v1.3.0

2021-02-01

Introduces a sortable playlist, upgrades Ruby, Rails, and Stimulus versions, and fixes mini player positioning on small screens.

v1.2.0

2020-11-09

Added support for various artists' albums and manual image settings, refactored CSS with ITCSS, and improved build environments and database storage.

v1.1.1

2020-07-16

Added support for oga and wma formats, replaced taglib-ruby with wahwah, and removed installation environment variable requirements.

v1.1.0

2020-05-31

This update replaces pgroonga with pg full text search, upgrades webpacker to 5.0, optimizes docker image size, and improves infinite scroll and login theme handling.