clangen/musikcube
Musikcube
Musikcube is a cross-platform audio player and high-performance C++ audio engine designed for managing local music libraries. It functions as both a terminal-based music player and a headless audio server capable of indexing metadata and playing audio across different operating systems.
The project utilizes a client-server architecture that separates the core audio engine and metadata indexer from the user interface. This design allows it to act as a self-hosted audio streaming server, delivering music and metadata to remote clients via WebSocket and HTTP with support for real-time transcoding and password-based authentication.
The system includes capabilities for local music library indexing through directory scanning and incremental metadata updates. It provides tools for playlist management, metadata querying, and global playback control via system-wide hotkeys. The audio engine supports multi-band equalization, preamp gain configuration, and various sound driver selections.
The software can be deployed as a background daemon to ensure constant availability during the system boot process.
Features
- Terminal Audio Players - A command-line audio player for managing and playing local music libraries across different operating systems.
- Terminal Players - Provides a full-featured music player designed specifically for text-based terminal environments.
- Terminal-Based Audio Playback - Provides a full-featured music player interface directly within the terminal.
- Music Library Indexing - Implements scanning of audio directories to build a searchable database of music files and metadata.
- Music Metadata Indexing - Indexes local music libraries using incremental updates to scan only modified files.
- Audio Data Serving - Hosts WebSocket and HTTP servers to deliver music streams and metadata to remote clients.
- Playback Controls - Implements essential transport controls including volume adjustment, seeking, and playback state management.
- Audio Playback Engines - Provides a high-performance C++ audio playback engine for local files and streams.
- Audio Streaming Servers - Operates as a headless background daemon that streams music and metadata to remote clients.
- Self-Hosted Streaming Servers - Functions as a self-hosted server to stream personal music collections to remote clients over a network.
- Cross-Platform Media Players - Ensures a consistent music playback experience across multiple supported operating systems.
- WebSocket-Based Application Command Interfaces - Uses a WebSocket-based command interface to synchronize playback state and metadata between the engine and external clients.
- Native C++ Implementations - Built with a native C++ implementation to ensure high-performance audio processing and hardware access.
- Client-Server Architecture - Employs a client-server architecture that decouples the audio engine and metadata indexer from the user interface.
- Playback Queue Managers - Manages the runtime sequential ordering of tracks for playback and supports queue snapshots.
- Music Metadata Querying - Allows searching and retrieving tracks, albums, and artists using filters, limits, and predicates.
- Global Playback Controllers - Provides system-wide hotkey management for global audio playback and volume control.
- Audio Output Configurations - Allows selection of sound drivers and volume modes to ensure hardware compatibility and stability.
- Audio Transcoding - Provides the ability to convert audio files to MP3 at specific bitrates during streaming.
- System Media Control Bindings - Integrates with the operating system to provide global playback control and volume management via hotkeys.
- Real-time Transcoding - Transcodes audio files into multiple bitrates in real time for HTTP delivery to remote clients.
- Playlist Management - Implements a system for creating, modifying, and organizing playlists of music tracks.
- Abstract Engine Interfaces - Utilizes abstract engine interfaces to allow the core audio engine to be controlled by diverse frontends.
- Background Service Daemonization - Can be deployed as a background daemon to ensure the music server is available automatically upon system boot.
- Global Shortcut Listeners - Captures global system hotkeys via OS hooks to control audio playback without window focus.
- Engine Control Interfaces - Provides a framework of classes and interfaces for supporting external user interfaces for engine and library control.
- Terminal Utilities - Cross-platform, terminal-based music player.
- Audio Streaming - Streaming audio server with cross-platform client support.
- Audio Utilities - Plays music through terminal.
- Media Streaming - Listed in the “Media Streaming” section of the Awesome Selfhosted awesome list.
- Music Players - Cross-platform terminal music player and server.
- Desktop Applications and Tools - Cross-platform terminal-based audio engine and player.
