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.0

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.0
File	Size	Uploaded
netease_cloudmusic_detector-2.0.0.tar.gz	20.8 kB	Aug 14, 2026	Details

Built distribution (wheel)

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

Total release size:34.7 kB

Release files / netease_cloudmusic_detector-2.0.0.tar.gz

Download URL	netease_cloudmusic_detector-2.0.0.tar.gz
Size	20.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`954f99226ce49ca512cb3b4320a4925155457c4735c8186ca740412afc0c6e38`
BLAKE2b-256 checksum How to use checksums	`a1e75c88ea3f620b5549533d701275b506a5bbc7c879819ef41f19070f4d44b4`
Upload date	Aug 14, 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.0-py3-none-any.whl

Download URL	netease_cloudmusic_detector-2.0.0-py3-none-any.whl
Size	13.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3be1f0d9cf9f595c8881112215f1f0f0602bf434c82ee8a7113754b4ef54e8a1`
BLAKE2b-256 checksum How to use checksums	`2ab373dfe5b7f7e45e1b6ae57ba2e7d72656104ad3f6797bad29c7cbdf1b007b`
Upload date	Aug 14, 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}`