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

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.1
File	Size	Uploaded
netease_cloudmusic_detector-2.0.1.tar.gz	21.3 kB	Aug 14, 2026	Details

Built distribution (wheel)

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

Total release size:35.5 kB

Release files / netease_cloudmusic_detector-2.0.1.tar.gz

Download URL	netease_cloudmusic_detector-2.0.1.tar.gz
Size	21.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`3b92964032edec3b761308e378300e304e673678502b9782c0ccacc64a95b93f`
BLAKE2b-256 checksum How to use checksums	`91a9f7ce782faff47878867cbda1060bbe2f860be5ef767ec724c29615b2bf8e`
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.1-py3-none-any.whl

Download URL	netease_cloudmusic_detector-2.0.1-py3-none-any.whl
Size	14.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`eac279822668379e5f513251d604d038f2dfeb43a1d38107c77ce0ac533d8c45`
BLAKE2b-256 checksum How to use checksums	`d5e28ebec9447494180fde8bbb2ad69321e88210b03e492cffe04e4898cffcfd`
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}`