93 lines
2.9 KiB
Markdown
93 lines
2.9 KiB
Markdown
---
|
|
title: Black Candy
|
|
created: 2026-06-08
|
|
updated: 2026-06-08
|
|
type: app
|
|
tags: [catalogue, music-streaming, app-marathon3-rattrapage-final-a]
|
|
confidence: medium
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Music%20Streaming&app=black-candy]
|
|
---
|
|
|
|
# 🍬 Black Candy
|
|
|
|
> Serveur de streaming musical minimaliste en Ruby on Rails, avec interface moderne type Spotify.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [blackcandy.vercel.app](https://blackcandy.vercel.app) |
|
|
| **GitHub** | [blackcandy-org/blackcandy](https://github.com/blackcandy-org/blackcandy) |
|
|
| **License** | MIT |
|
|
| **Langage** | Ruby |
|
|
| **Étoiles GitHub** | ~0.7k ⭐ |
|
|
| **Catégorie** | [[cat-music-streaming\|Music Streaming]] |
|
|
|
|
## 📝 Description
|
|
|
|
**Black Candy** est un serveur de streaming musical léger écrit en Ruby on Rails avec Stimulus + Tailwind pour le frontend. Il indexe une bibliothèque locale, génère des transcriptions HLS, supporte la recherche, les playlists, la lecture en continue et l'authentification multi-utilisateur. Interface épurée inspirée de Spotify, sans fioritures.
|
|
|
|
Différence vs Navidrome : stack Ruby on Rails monolithique (plus simple à débugger pour les Railsistes), contre Go+React pour Navidrome. Pour qui : amateurs de stack Ruby, petites collections personnelles (< 100k pistes).
|
|
|
|
## 🚀 Installation
|
|
|
|
### Docker Compose (recommandé)
|
|
|
|
```yaml
|
|
version: '3.8'
|
|
services:
|
|
blackcandy:
|
|
image: blackcandy/blackcandy:latest
|
|
container_name: black-candy
|
|
restart: unless-stopped
|
|
environment:
|
|
- RAILS_SERVE_STATIC_FILES=true
|
|
- DATABASE_URL=postgresql://blackcandy:blackcandy@db/blackcandy
|
|
- REDIS_URL=redis://redis:6379/0
|
|
depends_on:
|
|
- db
|
|
- redis
|
|
volumes:
|
|
- ./music:/music:ro
|
|
- ./storage:/rails/storage
|
|
labels:
|
|
traefik.enable: "true"
|
|
traefik.http.routers.blackcandy.rule: "Host(`music.example.com`)"
|
|
db:
|
|
image: postgres:16-alpine
|
|
environment:
|
|
POSTGRES_USER: blackcandy
|
|
POSTGRES_PASSWORD: blackcandy
|
|
POSTGRES_DB: blackcandy
|
|
volumes:
|
|
- ./db-data:/var/lib/postgresql/data
|
|
redis:
|
|
image: redis:7-alpine
|
|
```
|
|
|
|
## 🔄 Alternatives
|
|
|
|
### Open Source
|
|
- [[app-navidrome]] — Référence moderne en Go
|
|
- [[app-funkwhale]] — Fédéré, multi-audio
|
|
- [[app-koel]] — Streaming musical Laravel/JS
|
|
|
|
### Propriétaires
|
|
- **Spotify** — Streaming commercial dominant
|
|
- **Apple Music** — Catalogue Apple
|
|
|
|
## 🔐 Sécurité
|
|
- **Auth** : comptes locaux (Devise), pas d'OIDC natif
|
|
- **Médias** : URLs signées temporaires pour les streams
|
|
- **Scan média** : processus d'indexation Rscan, attention aux tags ID3 corrompus
|
|
|
|
## 📚 Ressources
|
|
- [Documentation](https://github.com/blackcandy-org/blackcandy#readme)
|
|
- [GitHub](https://github.com/blackcandy-org/blackcandy)
|
|
|
|
## Pages Liées
|
|
- [[cat-music-streaming]] — Catégorie Music Streaming
|
|
- [[app-navidrome]] — Concurrent principal
|
|
- [[recettes-docker-compose]] — Templates Docker
|