网易云音乐 Golang API 接口 + 命令行工具套件 + 一键完成任务
本项目仅供个人学习使用,切勿用于商业用途、非法用途使用！！！如有侵权,即删。
- 一键每日任务完成(音乐合伙人、云贝签到、刷歌300首)
- 每日签到(云贝签到,连续签到奖励目前需要手动领取)
- “音乐合伙人”自动测评
- 每日刷歌300首(带去重功能)
- 云盘上传(支持并行批量上传)
- .ncm文件解析转换为.mp3/.flac(支持并行批量解析)
-
crypto支持接口参数加解密便于调试 -
curl子命令调用网易云音乐API,无需关心出入参数加解密问题便于调试- 支持动态链接请求
- 音乐下载，支持标准、高品质、极高(HQ)、无损(SQ)、Hi-Res品质下载
- vip每日签到
- vip日常任务完成(待考虑)
- “音乐人”任务自动完成(待考虑)
- proxy 代理
- weapi 网页端、小程序使用
- eapi PC端、移动端使用
目前由于本人时间精力有限,暂未书写文档,不过可以参考api目录下代码,代码通俗易懂,且有注释.
提示: 目前主要实现了weapi也推荐使用weapi,接口相对较全，如需要其他接口可提 issue。
- golang >= 1.21
- makefile (可选)
- git (可选)
- docker (可选)
可执行文件安装
go install github.com/chaunsin/netease-cloud-music/cmd/ncmctl@latest或
git clone https://github.com/chaunsin/netease-cloud-music.git
cd netease-cloud-music && make install提示: 默认会安装到$GOPATH/bin目录下
docker版本镜像获取方式
docker pull chaunsin/ncmctl:latest镜像仓库以及docker使用方式: https://hub.docker.com/r/chaunsin/ncmctl
如有条件自编译镜像
git clone https://github.com/chaunsin/netease-cloud-music.git
cd netease-cloud-music && make build-iamge提示: 自行编译需要安装docker环境,另外受国服环境影响最好开梯子。
一、二维码登录
ncmctl login qrcode提示: 使用手机登录网易云音乐app进行扫码授权登录，如果不能识别终端打印的二维码可根据终端输出得文件路径提示找到二维码图片进行扫描,或者copy终端输出得
qrcode content: https://www.163.com/xxx 内容进行自己生成二维码再进行扫描(粘贴时不要包含qrcode content:
以及结尾空格)。另外扫码过程中
不能退出终端!!! 如有问题可重复此流程,为避免被风控不要频繁登录。
在线生成二维码工具: https://www.bejson.com/convert/qrcode/#google_vignette
二、一键执行每日所有任务
ncmctl task提示: 默认task包含
- sign (签到)
- partner (音乐合伙人)
- scrobble (刷歌300首)
如果只运行某一个任务,比如签到:
ncmctl task --sign另外partner"音乐合伙人"资格不是所有人都有，网易会不定期私信邀请一部分人成为音乐合伙人。由于ncmctl task
默认是执行所有任务，因此没有该资格得人执行如下
ncmctl task --sign --scrobble 如果想更改某一个任务默认运行时间,比如刷歌(scrobble)在每天晚上20:00:00点执行.
ncmctl task --scrobble.cron "0 20 * * *"提示:
三、音乐下载
- 下载Hi-Res品质音乐
# 指定歌曲分享链接
ncmctl download -l hires 'https://music.163.com/song?id=1820944399'
# 指定歌曲id
ncmctl download -l hires '1820944399'提示: url地址获取方式可以从分享中获取。如果知道歌曲id可以省略url地址，目前id仅支持歌曲id，不支持其他例如歌手、专辑、歌单id等。
- 下载无损品质(SQ)音乐,到当前
download目录下
ncmctl download -l SQ 'https://music.163.com/song?id=1820944399' -o ./download/ 提示: 支持得音质有(从低到高) standard/128 < higher/192 < exhigh/HQ/320 < lossless/SQ < hires/HR
- 下载某一张专辑所有音乐,批量下载数量5(最大值20)
ncmctl download -p 5 'https://music.163.com/#/album?id=34608111'提示: 默认批量下载到当前download目录下面，音质为无损(SQ)
- 下载某一歌手的所有音乐
ncmctl download --strict 'https://music.163.com/#/artist?id=33400892'提示: --strict为严格默认,当歌曲没有对应品质的音乐时则会忽略下载,如果不指定--strict则默认下载次一级的音乐品质。
- 下载某一歌单
# web端
ncmctl download 'https://music.163.com/#/my/m/music/playlist?id=593617579'
# pc端
ncmctl download 'https://music.163.com/playlist?id=593617579'四、云盘上传
指定文件上传
ncmctl cloud '/Users/chaunsin/Music/谁为我停留 - 田震.mp3' 指定目录上传(批量上传)
ncmctl cloud '/Users/chaunsin/Music/' 提示: 默认批量上传数为3,最大为10,可指定-p参数设置,同时cloud支持按照自定义过滤条件进行上传详情可参考命令行。另外输入的目录深度不能超过3层。
五、.ncm文件解析
批量解析/Users/chaunsin/Music/目录输出到./ncm目录下
ncmctl ncm '/Users/chaunsin/Music/' -o ./ncm提示: 支持批量解析,默认参数为10，可以指定-p参数设置数量。另外输入的目录深度不能超过3层。
六、其他命令
$ ncmctl --help
ncmctl is a toolbox for netease cloud music.
Usage:
ncmctl [command]
Examples:
ncmctl cloud
ncmctl crypto
ncmctl login
ncmctl curl
ncmctl partner
Available Commands:
cloud [need login] Used to upload music files to netease cloud disk
completion Generate the autocompletion script for the specified shell
crypto Crypto is a tool for encrypting and decrypting the http data
curl Like curl invoke netease cloud music api
download [need login] Download songs
help Help about any command
login Login netease cloud music
logout Logout netease cloud music
ncm Automatically parses .ncm to mp3/flac
partner [need login] Executive music partner daily reviews
scrobble [need login] Scrobble execute refresh 300 songs
sign [need login] Sign perform daily cloud shell check-in and vip check-in
task [need login] Daily tasks are executed asynchronously [partner、scrobble、sign]
Flags:
-c, --config string configuration file path
--debug run in debug mode
-h, --help help for ncmctl
--home string configuration home path. the home path is used to store running information (default "/Users/chaunsin")
-v, --version version for ncmctl
Use "ncmctl [command] --help" for more information about a command.
提示: 内容以实际命令行为准
参考如下
当使用ncmctl下载无损音乐指定-l lossless时,会存在下载Hi-Res品质音乐情况,如果歌曲不支持Hi-Res品质音乐,同时有无损音乐则正常下载无损音乐,问题还需要排查。
scrobble是支持去重功能的,会在$HOME/.ncmctl/database/记录听过哪些歌曲记录的，但是目前没有找到这样的一个接口,判断当前账户听过哪些歌曲,因此这就会造成每日听歌达不到300首的情况。
举个例子,在使用本程序之前,你听过某一首歌曲比如反方向的钟 - 周杰伦
,由于此歌曲没有记录到数据库中,即视为未听过歌曲,这就造成了重复播放,进而导致不满足300首。
综上所述强烈建议不要清理$HOME/.ncmctl/database/目录下的文件数据,除非你知道你在干什么。
另外还有一种极端情况,刷歌采用的歌单是top榜单歌曲(top榜单歌曲相对来说都是新歌,不同得歌单更新频率不一样) ，top榜单有50个左右，虽然看起来很多,但实际上还是存在不满足300首新歌情况,如果网易新歌曲更新得不及时,由于有判重复逻辑,因此还是会存在不满足300首得情况。
task命令是一个服务，默认执行是包含了scrobble、sign、partner子命令功能，启动之后会每天定时得去执行,也就是说把此命令部署到服务器上并配合
nohup命令去启动就不用每天手动去执行一遍任务了。
再说一下scrobble、sign、partner。这几个子命令不是服务，执行之后会立刻执行相应得任务并返回结果，不像task执行需要”到点了“才会执行。
- https://github.com/Binaryify/NeteaseCloudMusicApi
- https://github.com/mos9527/pyncm
- https://github.com/naruto2o2o/musicdump
- https://crontab.guru
以及本项目所依赖的三方优秀库。