Black Candy

A self-hosted music streaming server with a clean, modern interface. Built with Rails and Hotwire, using SQLite for storage so no external database is needed.

Default Setup

1. Visit your domain after deployment
2. Create an admin account — on first access, you'll be prompted to set up the initial admin user
3. Upload music — place audio files in the /media_data volume; Black Candy will automatically scan and index them

What You Can Do After Deployment

1. Upload and stream music — supports MP3, FLAC, OGG, AAC, OPUS, WAV, and WMA formats
2. Browse your library — view by artist, album, or song with album art display
3. Create playlists — organize your music into custom playlists
4. Mark favorites — save your favorite songs and albums for quick access
5. Multi-user support — create additional user accounts
6. Use mobile apps — native iOS and Android apps available

Key Features

• Clean, modern web interface with responsive design
• SQLite storage — no external database needed
• Supports MP3, FLAC, OGG, AAC, OPUS, WAV, and WMA
• Album art display and media metadata parsing
• Playlist and favorites management
• Multi-user support
• Native iOS and Android apps
• Dark mode support

Music Library

Place your music files in the /media_data volume. Black Candy automatically scans this directory and imports audio files with their metadata and album art.

License

MIT — GitHub