netease-cloudmusic-detector (Python 版)

本项目基于Coooookies/netease-cloudmusic-detector这一开源项目，使用GLM5.0 Turbo进行重写为Python版本，并保留了原作者的LICENSE。在此感谢原作者的开源

以下为AIGC内容

使用 Python 监听网易云音乐客户端正在播放中的音乐。

支持获取 SongId、暂停状态、歌曲进度，歌曲进度跟随进度条拖拽同步。仅支持 3.0 以上客户端。

环境要求

Python >= 3.10
Windows 系统已安装网易云音乐客户端 3.0+
客户端至少运行过一次（以生成 elog 文件）

安装

# 使用 uv
uv sync

# 或使用 pip
pip install -e .

使用

uv run python main.py

依赖

无第三方依赖，仅使用 Python 标准库。

文件结构

cloudmusic_detector/
├── __init__.py        # 包入口
├── elog_analysis.py   # 二进制解码 + 日志头解析
├── elog_listener.py   # 文件轮询监听
├── constant.py        # 路径常量 + 事件匹配规则
├── webdb.py           # SQLite 只读查询
└── detector.py        # 核心调度器
main.py               # 示例入口
test_decode.py         # 测试脚本

事件

事件名	触发时机	参数
`play`	切歌时	`song_id: int`
`status`	播放/暂停切换	`playing: bool`
`position`	进度拖拽	`position: float`

Release files for netease-cloudmusic-detector 2.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for netease-cloudmusic-detector 2.0.4
File	Size	Uploaded
netease_cloudmusic_detector-2.0.4.tar.gz	22.7 kB	Aug 16, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for netease-cloudmusic-detector 2.0.4
File	Interpreter	ABI	Platform	Reset
netease_cloudmusic_detector-2.0.4-py3-none-any.whl 15.0 kB Aug 16, 2026	Python 3	none	any	Details

Total release size:37.7 kB

Release files / netease_cloudmusic_detector-2.0.4.tar.gz

Download URL	netease_cloudmusic_detector-2.0.4.tar.gz
Size	22.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`d7d01ee4d83847cb25ff179119583187c0a1d663e364c035bd63608daec0ca2a`
BLAKE2b-256 checksum How to use checksums	`4175bd17a2b690e6fbce0ba66d6b9cd3a3996eb7cdc11f67c5b7d46b6bb40974`
Upload date	Aug 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / netease_cloudmusic_detector-2.0.4-py3-none-any.whl

Download URL	netease_cloudmusic_detector-2.0.4-py3-none-any.whl
Size	15.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c66139e1dbdffa43ccad531f5ee96dc721565bc2cfa030db2730d8a825c1bbe8`
BLAKE2b-256 checksum How to use checksums	`2458973b770f735edae50699b1d57f488e927278343e8156ca1413f7db4b3f6f`
Upload date	Aug 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`