# darknessomi/musicbox

网易云音乐命令行版本

Repository: https://github.com/darknessomi/musicbox
Canonical: https://ross.abutalabs.com/products/musicbox
Language: Python
License: MIT
License Family: permissive
Topics: music, netease-musicbox, python, linux, cli-tool
Last push: 2026-07-21T02:57:57+00:00

## Health v2 (maintenance only)
Score: 92/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 93, release rhythm 87, longevity 100
- inputs: {"age_days": 4411, "days_push": 43, "days_rel": 85, "gap_med": 3.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9833, forks 1563 (observed 2026-08-28T04:10:37.422281+00:00)

## What it is
NetEase-MusicBox is a Python-based command-line client for NetEase Cloud Music supporting multiple audio qualities including lossless FLAC and Hi-Res. It offers fuzzy search, playlists, radio, daily recommendations, and both interactive terminal UI and scriptable CLI commands usable by AI agents.

## Use cases
- play netease cloud music from the terminal
- search and play songs via command line with json output
- listen to lossless flac music in a terminal client
- control music playback from scripts or ai agents
- browse playlists and daily recommendations without a browser
- run a lightweight music player on raspberry pi

## When to choose
- you want to use NetEase Cloud Music without a GUI
- you live in the terminal and want vim-style keybindings
- you need scriptable music search and playback commands
- you run a headless or low-resource device like a Raspberry Pi

## When to avoid
- you need a graphical music player with album art
- you don't have a NetEase Cloud Music account (QR-code login required)
- you primarily use streaming services other than NetEase

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, audio-processing, search-engine
- domain: media, developer-tools
- platform: cli, python, cross-platform
- tags: music-player, netease-cloud-music, terminal-ui, tui, music-streaming, flac, hi-res-audio, command-line, linux, macos

## Member repositories
- darknessomi/musicbox (main) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:37.422281+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:20:55.542403+00:00, confidence not recorded.
  - readme: https://github.com/darknessomi/musicbox (fetched 2026-08-28T04:10:37.422281+00:00, sha 6dd97b362364)
  - registry_pypi: https://pypi.org/pypi/musicbox/json (fetched 2026-08-29T08:20:23.813566+00:00, sha 384be5d6c7e0)
- Data as of 2026-08-30T08:39:29.467469+00:00.