blackcandy

A self hosted music streaming server

⭐ 4,181 stars on GitHub · 🍴 208 forks · 📜 License: mit · 💻 Language: Ruby

What is blackcandy?

A self-hosted media server — turn your NAS/VPS into a personal cinema. Stream movies & music to your household without subscription dependency.

The biggest strength is offline-first streaming + ad-free + unlimited library scaled by your disk size.

Best for families building home theaters, small hotels streaming internal media, creators archiving work.

Topics: the project is tagged with popular topics:

• 🏷️ audio
• 🏷️ hotwire
• 🏷️ music
• 🏷️ music-player
• 🏷️ music-streaming
• 🏷️ musicplayer
• 🏷️ rails
• 🏷️ ruby
• 🏷️ self-hosted

📸 Screenshots

Quick install

See the README for detailed install instructions. Most projects support Docker — if the repo has a Dockerfile, use:

git clone https://github.com/blackcandy-org/blackcandy.git
cd blackcandy
docker build -t blackcandy .
docker run -d -p 8080:8080 blackcandy

Minimum system requirements

⚡ Deploy fast on VSIS

Use the VSIS VPS Mini 1GB RAM / 1 vCPU / 15GB SSD (~70k/tháng) plan from VSIS.NET — high-speed VN-based VPS, 24/7 support, ideal for running blackcandy smoothly.

🎯 Benefits:

• One-command docker compose up -d deploy in 2 minutes
• Dedicated IPv4, root access, unmetered domestic bandwidth
• Daily snapshot backup
• Free install assistance from the VSIS team

👉 See matching VPS plans at vsis.net

Resources

• 🔗 GitHub: blackcandy-org/blackcandy
• 📚 Official docs: see README in the repo
• 💬 Community: GitHub Issues + Discussions

Article compiled from GitHub data on 05/05/2026. Star/fork counts may have changed — see live numbers via the GitHub link.