Black Candy

Black Candy is a self-hosted music streaming server that turns your own music library into a personal music center.

  • Media Applications
  • Media Servers
  • Tools & Utilities
Black Candy is a self-hosted music streaming server that turns your own music library into a personal music center. It stores, organizes, and streams your tracks to any device, and ships mobile apps for iOS and Android, so homelabbers can listen to their own collection at home and on the go.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

82/100 Excellent

Maintained
98last commit 45 days ago
Popular
734,432 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data
Security check
100no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 23 days ago

GitHub stars
4,432
Open issues
32
Last commit
2026-10-07
Latest release
v3.2.1
License
MIT
Activity
stale

Checked 8 days ago - source: GitHub (blackcandy-org/blackcandy)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Permissions and first login Black Candy's container runs as UID/GID 1000:1000, so set ownership of your data directory before the first start (e.g., chown 1000:1000 /mnt/cache/appdata/blackcandy -R). After the first launch, log in with the default admin account: email [email protected], password foobar. source

Fetched 47 days ago - each note links to its source

Alternatives (5)

  • Ampache - Ampache is a self-hosted, web-based media server that streams and manages your music and video libraries from any device.
  • Funkwhale - Open-source, self-hosted streaming platform supports Android, iOS, podcasts, uploads, sharing, no ads or tracking, federated across decentr…
  • Navidrome - Navidrome is a modern self-hosted music server and streamer that organizes personal music libraries and provides Subsonic/Airsonic-compatib…
  • Plexamp - Plexamp is a small music player for your desktop, with a number of unique features.Throw your best FLACs at it and experience sonic bliss!.
  • Subsonic - Subsonic is a free, web-based media streamer, providing ubiquitous access to your music and video.

Checked 54 days ago - source: AlternativeTo

Common questions

What initial credentials should I use to log in to the web UI?

Use the initial admin account with email [email protected] and password foobar.

What ownership change is required for the application data directory?

The application directory must be owned by UID/GID 1000:1000, so chown it recursively to 1000:1000.

Are official mobile clients available?

Yes, an Android app is available on F-Droid and an iOS app is available on the Apple App Store.

Can multiple listeners use the same server?

Yes, Black Candy supports multi-user management so individual listeners can have personalized experiences.

Answers sourced from github.com, selfhostedhub.com

Community

Collected 53 days ago - public community threads