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

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.2
File	Size	Uploaded
netease_cloudmusic_detector-2.0.2.tar.gz	21.7 kB	Aug 16, 2026	Details

Built distribution (wheel)

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

Total release size:36.2 kB

Release files / netease_cloudmusic_detector-2.0.2.tar.gz

Download URL	netease_cloudmusic_detector-2.0.2.tar.gz
Size	21.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`227f84af3a0351c67a6d2d7c0be35430fc657c6029a486f4c66d021d35dfc8db`
BLAKE2b-256 checksum How to use checksums	`9ecd39fdaa4864e8294c35c02928061f7886c73fd7aa257df3bd3955cf28ec4c`
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.2-py3-none-any.whl

Download URL	netease_cloudmusic_detector-2.0.2-py3-none-any.whl
Size	14.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`59947b3e1c9bd4b4827f0b4c42064aa913f13711750cf7934584a78c376f7af1`
BLAKE2b-256 checksum How to use checksums	`172429afc1f32b2c82c82b1b9d228f7e72bceff8622c8f516294d335fa3a5fb1`
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}`