darknessomi/musicbox
Musicbox
Musicbox is a terminal-based music player and command-line interface client for NetEase Cloud Music. It functions as a keyboard-driven audio player that enables users to stream music, manage playlists, and browse charts directly within a terminal environment.
The project utilizes a headless music daemon to separate background audio playback and authentication from the command-line interface. This architecture allows for audio control via external commands or agents and includes a desktop lyrics overlay capable of dual-line rendering and foreign language translations.
The system covers high-fidelity audio streaming with support for lossless audio and local disk caching for offline playback. It includes tools for music discovery via fuzzy search, personal library organization, and automated account management, including daily check-in synchronization.
Features
- Music Streaming - Functions as an alternative command-line client for the NetEase Cloud Music streaming platform.
- Media Playback Controllers - Provides a command-line interface for controlling audio playback and search queries via a background daemon.
- Audio Playback - Implements a headless background daemon for managing audio playback via external commands or shortcuts.
- Lossless Audio Streaming - Supports high-fidelity audio streaming ranging from standard MP3 to high-resolution lossless formats.
- Terminal Players - Provides a keyboard-driven music player designed specifically for terminal environments.
- Streaming Clients - Provides a client for streaming and discovering music from the NetEase Cloud Music service.
- Audio Daemons - Utilizes a headless music daemon to separate background playback and authentication from the CLI.
- Token-Based Authentication - Uses cryptographic tokens retrieved via QR codes or email to maintain secure user sessions.
- User Account Management - Manages user authentication states and automates daily check-ins to maintain account benefits.
- Client-Server Architecture - Employs a client-server architecture to separate a persistent background audio daemon from the terminal user interface.
- Account Automation Frameworks - Automates repetitive account interactions, such as daily check-ins, to maintain account status.
- Playback Controllers - Provides programmatic control over playback progress, shuffle and repeat modes, and play queue organization.
- Personal Media Managers - Enables users to organize personal music collections and maintain lists of favorite tracks.
- Fuzzy Search Engines - Implements a fuzzy search engine to match user queries against remote music catalogs and artist lists.
- Offline Caching - Stores streamed audio data on the local file system to ensure stable playback and enable offline access.
- Overlay Rendering Engines - Provides a synchronized text overlay engine for rendering song lyrics on top of other desktop windows.
- Lyric Overlays - Ships a desktop lyrics overlay with dual-line rendering and foreign language translations.
- Music Discovery - Implements fuzzy search and recommendation features to find music across remote catalogs and local lists.
- Audio Playlist Managers - Retrieves curated music collections from global charts, new releases, and personalized recommendation engines.
- Media Overlays - Ships a floating media overlay for displaying song lyrics with dual-line rendering and translations.
- Developer Tools - Command-line music player for programmers.
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.
