Skip to main content

netease-cloudmusic-detector (Python 版)

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

本项目已上传到Pypi:网易云音乐检测器 ·PyPI

以下为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.5

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.5
File Size Uploaded
netease_cloudmusic_detector-2.0.5.tar.gz 23.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for netease-cloudmusic-detector 2.0.5
File Interpreter ABI Platform
netease_cloudmusic_detector-2.0.5-py3-none-any.whl Python 3 none any Details

Total release size:38.8 kB

Release files / netease_cloudmusic_detector-2.0.5.tar.gz

Download URL netease_cloudmusic_detector-2.0.5.tar.gz
Size 23.6 kB
Tags Source
SHA-256 checksum
How to use checksums
30a49590fe7b38b136dc63f698abf06686c34cfc8dc309ddb840a6408d4e2e83
BLAKE2b-256 checksum
How to use checksums
1c78dfc518a2062e7c7b2f534cabe11e9ec6c151dd23d395e516f80003f6e92a
Upload date
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.5-py3-none-any.whl

Download URL netease_cloudmusic_detector-2.0.5-py3-none-any.whl
Size 15.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1ea879da2ed940d829caaee4adf31a11ac22959206ae11ecc3023df3e6dfc472
BLAKE2b-256 checksum
How to use checksums
4e145a5be67a2a5bcbc17f2c3a953ce56519df400100deb6f6095fe5fa412bf5
Upload date
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 history Release notifications | RSS feed

2.0.6

2 release files

This release

2.0.5 This release

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page