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

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.3
File	Size	Uploaded
netease_cloudmusic_detector-2.0.3.tar.gz	22.0 kB	Aug 16, 2026	Details

Built distribution (wheel)

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

Total release size:36.7 kB

Release files / netease_cloudmusic_detector-2.0.3.tar.gz

Download URL	netease_cloudmusic_detector-2.0.3.tar.gz
Size	22.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`3ed809dee3f302cc7793da704c33a66b9109786df97b7173ff00c5de85038c50`
BLAKE2b-256 checksum How to use checksums	`0e269279611b0811a80b32a9ad6b632564bef1208aa923df8861b2b77570e62e`
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.3-py3-none-any.whl

Download URL	netease_cloudmusic_detector-2.0.3-py3-none-any.whl
Size	14.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`44623cd765e1bfeea1fdfd438f87a5418ee03014e5cbd3e9a569f60b47e9d028`
BLAKE2b-256 checksum How to use checksums	`34dbe76baf69141d256cb0bc728eda92291039d764837896b58c0e3a7ebc457b`
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}`