# darknessomi/musicbox **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/darknessomi-musicbox).** 9,806 stars · 1,562 forks · Python · MIT ## Links - GitHub: https://github.com/darknessomi/musicbox - awesome-repositories: https://awesome-repositories.com/repository/darknessomi-musicbox.md ## Topics `cli-tool` `linux` `music` `netease-musicbox` `python` ## Description 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. ## Tags ### Part of an Awesome List - [Music Streaming](https://awesome-repositories.com/f/awesome-lists/media/music-streaming.md) — Functions as an alternative command-line client for the NetEase Cloud Music streaming platform. ### Development Tools & Productivity - [Media Playback Controllers](https://awesome-repositories.com/f/development-tools-productivity/command-line-interface-controllers/media-playback-controllers.md) — Provides a command-line interface for controlling audio playback and search queries via a background daemon. ([source](https://github.com/darknessomi/musicbox/blob/master/CHANGELOG.md)) ### Graphics & Multimedia - [Audio Playback](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-playback.md) — Implements a headless background daemon for managing audio playback via external commands or shortcuts. - [Lossless Audio Streaming](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-streaming-engines/lossless-audio-streaming.md) — Supports high-fidelity audio streaming ranging from standard MP3 to high-resolution lossless formats. ([source](https://github.com/darknessomi/musicbox/blob/master/README.md)) - [Terminal Players](https://awesome-repositories.com/f/graphics-multimedia/audio-music/music-utilities/terminal-players.md) — Provides a keyboard-driven music player designed specifically for terminal environments. - [Streaming Clients](https://awesome-repositories.com/f/graphics-multimedia/music-streaming-management/streaming-clients.md) — Provides a client for streaming and discovering music from the NetEase Cloud Music service. - [Offline Caching](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-playback/offline-caching.md) — Stores streamed audio data on the local file system to ensure stable playback and enable offline access. - [Overlay Rendering Engines](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/post-processing-pipelines/multi-pass-rendering-pipelines/real-time-rendering-engines/overlay-rendering-engines.md) — Provides a synchronized text overlay engine for rendering song lyrics on top of other desktop windows. - [Lyric Overlays](https://awesome-repositories.com/f/graphics-multimedia/lyric-overlays.md) — Ships a desktop lyrics overlay with dual-line rendering and foreign language translations. - [Music Discovery](https://awesome-repositories.com/f/graphics-multimedia/music-discovery.md) — Implements fuzzy search and recommendation features to find music across remote catalogs and local lists. ([source](https://github.com/darknessomi/musicbox/blob/master/CHANGELOG.md)) - [Audio Playlist Managers](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/playlist-aggregators/personal-playlist-managers/audio-playlist-managers.md) — Retrieves curated music collections from global charts, new releases, and personalized recommendation engines. ([source](https://github.com/darknessomi/musicbox#readme)) ### Operating Systems & Systems Programming - [Audio Daemons](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/system-services/background-daemons/audio-daemons.md) — Utilizes a headless music daemon to separate background playback and authentication from the CLI. ### Security & Cryptography - [Token-Based Authentication](https://awesome-repositories.com/f/security-cryptography/token-based-authentication.md) — Uses cryptographic tokens retrieved via QR codes or email to maintain secure user sessions. - [User Account Management](https://awesome-repositories.com/f/security-cryptography/user-account-management.md) — Manages user authentication states and automates daily check-ins to maintain account benefits. ([source](https://github.com/darknessomi/musicbox/blob/master/CHANGELOG.md)) ### Software Engineering & Architecture - [Client-Server Architecture](https://awesome-repositories.com/f/software-engineering-architecture/client-server-architecture.md) — Employs a client-server architecture to separate a persistent background audio daemon from the terminal user interface. ### System Administration & Monitoring - [Account Automation Frameworks](https://awesome-repositories.com/f/system-administration-monitoring/account-management-apis/account-automation-frameworks.md) — Automates repetitive account interactions, such as daily check-ins, to maintain account status. ### User Interface & Experience - [Playback Controllers](https://awesome-repositories.com/f/user-interface-experience/playback-controllers.md) — Provides programmatic control over playback progress, shuffle and repeat modes, and play queue organization. ([source](https://github.com/darknessomi/musicbox#readme)) - [Media Overlays](https://awesome-repositories.com/f/user-interface-experience/media-overlays.md) — Ships a floating media overlay for displaying song lyrics with dual-line rendering and translations. ([source](https://github.com/darknessomi/musicbox/blob/master/README.md)) ### Business & Productivity Software - [Personal Media Managers](https://awesome-repositories.com/f/business-productivity-software/personal-media-managers.md) — Enables users to organize personal music collections and maintain lists of favorite tracks. ([source](https://github.com/darknessomi/musicbox/blob/master/README.md)) ### Data & Databases - [Fuzzy Search Engines](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-information-retrieval/matching-ranking-logic/fuzzy-search-engines.md) — Implements a fuzzy search engine to match user queries against remote music catalogs and artist lists.