darknessomi/musicbox

Pythonで書かれた高品質なNetEase Cloud Musicコマンドラインクライアントです。

MusicBoxの開発に尽力してくださった皆さん、ありがとうございます。

Netease Cloud MusicのAPI機能はNeteaseCloudMusicApiEnhanced/api-enhancedによってサポートされています。

デモ

機能的特徴

• マルチレベルオーディオ再生に対応しています:MP3(超高/高/標準)およびロスレス、HD Authentic、Ultra HDマスタリング、その他のFLACに対応し、インストール後は自動的に切り替えます。
• 曲、アーティスト、アルバム、ローカルリストの曖昧検索をサポートします
• チャート、新アルバムリスト、キュレーションされたプレイリスト、アンカーラジオ、マイプレイリスト、マイクラウドドライブ、プライベートFM、日々のおすすめをサポート
• 地元の人気曲、曲レビュー、アルバムジャンプ、カジュアルDJ、予定された退場のサポート
• 再生進行状況、再生モード、現在/過去のプレイリスト、デスクトップ歌詞表示をサポートしています
• Vimスタイルのショートカット、数値ショートカット、カスタムグローバルショートカットのサポート

設置

グローバルコマンドmusicboxはuvまたはpipxでインストールすることが推奨されます。開発への関与については、下記の「ローカル開発」を参照してください。

環境要件

• Python 3.10以上
• mpg123(MP3)、mpv(オプション、FLAC / Hi-Res)

システム依存関係のインストール

macOS:

Ubuntu/Debian:

CentOS/Red Hat:

MusicBoxのインストール

PyPI(ソースコードに遅れをとる場合があります):

ソースコード(グローバルコマンド;コードを修正した後に再インストールし、開発中に使用可能-e):

ローカル開発(グローバル指揮なし):

オプション依存関係

• aria2:キャッシュされた曲
• libnotify-bin:Linuxメッセージプロンプト
• qtpy python-dbus dbus qt:デスクトップの歌詞。システムQtのバージョンによっては、pyqt4、pyside、またはpyside2のインストールが必要になる場合もあります。

ラズベリーパイ / 時代遅れの機器

Ubuntu 22.04 / 64ビットのRaspberry PiシステムにはPython 3.10が搭載されており、pipxから直接インストール可能です。低パフォーマンスデバイスでは、大量のグラフィック/ビデオ依存関係を一度に引き出さないためにMP3再生依存のみをインストールすることが推奨されます。

注:このプロジェクトにはPython 3.10以上のものが必要です。古いRaspberry Pi OSやDebianがまだPython 3.9を動かしている場合、現在のバージョンを直接インストールすることはできません。

システム検証済み

• Ubuntu 24.04 LTS x64
• macOS 26.5
• Raspberry Pi 4 / Ubuntu 22.04 arm64(Dockerイメージ:balenalib/raspberrypi4-64-ubuntu:jammy)

使用法

ミュージックボックス開始:

ログインが必要な機能にアクセスすると、端末はQRコードを表示します。ログインはコードのスキャンのみをサポートし、アカウントとパスワードのログインはサポートしていません。