blackcandy-org/blackcandy
Blackcandy
Blackcandy is a self-hosted music streaming server and digital music library manager. It allows users to host personal collections of audio files on a private server for streaming to web browsers and dedicated mobile applications.
The system includes a media library sync engine that monitors file system changes in the background and uses parallel processing to keep the music database synchronized. It manages library organization by extracting audio metadata and fetching artist and album imagery from external databases.
The platform provides capabilities for remote audio playback, music library search, and secure credential storage using password hashing encryption. It supports configurable database backends and media directory mounting to organize and serve audio files from specific paths.
The server is provided as a containerized media server for consistent installation across different hosting platforms.
Features
- Audio Streaming Servers - Operates as a self-hosted server that distributes audio streams and metadata to remote web and mobile clients.
- Self-Hosted Music Platforms - Provides a privately hosted platform for managing, tagging, and streaming personal music collections.
- External Metadata Integration - Retrieves artist and album information and imagery from third-party databases to enrich the local music library.
- Music Library Managers - Provides a system for organizing and accessing local audio collections through metadata extraction and enrichment.
- Media Library Synchronization - Monitors file system changes to automatically synchronize the music database with the local media collection.
- Album Art Retrievals - Automatically fetches and saves album cover art from online sources to populate the music library.
- Media Metadata Extraction - Extracts technical information and descriptive tags from audio files to organize the music library.
- Music Playback - Allows playing music from a personal library across any device including Android and iOS.
- Music Streaming Interfaces - Provides a web-based interface for accessing and playing music collections hosted on a private server.
- Self-Hosted Streaming Servers - Acts as a self-hosted server designed to stream personal media collections to remote clients.
- Remote Library Access - Enables remote playback of the private music library through dedicated Android and iOS applications.
- Music Metadata Retrieval - Searches and retrieves specific music release data and imagery from external databases using authentication tokens.
- Parallel Indexing - Uses multiple processing threads to accelerate the scanning and indexing of audio files during library synchronization.
- Pluggable Database Backends - Supports switching between lightweight local storage and external relational databases for different scaling requirements.
- Relational Database Backends - Persists application data to either SQLite or external relational databases for flexible storage configuration.
- Container Deployment - Provides a standardized container image for consistent deployment across different hosting environments.
- Containerized Deployments - Uses standardized container packaging to ensure consistent application execution across diverse hosting environments.
- Containerized Media Services - Ships as a containerized media service for consistent deployment across different hosting environments.
- Container Directory Mounting - Binds host directories to container paths to serve audio files from specific local filesystem paths.
- Asynchronous File System Monitoring - Implements background tracking of file system changes to update the music database without blocking the main process.
- Audio Servers - Self-hosted server for personal music management.
- Media Streaming - Listed in the “Media Streaming” section of the Awesome Selfhosted awesome list.
- Music Streaming - Music streaming server with cross-platform mobile and web support.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
