Skip to main content

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 1.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 1.0.0
File Size Uploaded
netease_cloudmusic_detector-1.0.0.tar.gz 20.2 kB Details

Built distribution (wheel)

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

Total release size:33.4 kB

Release files / netease_cloudmusic_detector-1.0.0.tar.gz

Download URL netease_cloudmusic_detector-1.0.0.tar.gz
Size 20.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f33a19a53ddc4e98c7b75fa3fd9e0f9241c6eb5e71c9f9c230258274ea2d0b7c
BLAKE2b-256 checksum
How to use checksums
7945e9f22117a980f16febba7fd84285ff34fe46aa84796263be935fb85eca8e
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-1.0.0-py3-none-any.whl

Download URL netease_cloudmusic_detector-1.0.0-py3-none-any.whl
Size 13.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
30a59039001086ffe3d4894d1afee91b309b7bd7e0c29b1e443b054e530502af
BLAKE2b-256 checksum
How to use checksums
3181a16b5fe9d1ef352f8d28c876c1e1d233acd6ab320ee2d166eb61aa66ba78
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

2.0.5

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

This release

1.0.0 This release

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