🏷️ yun-playlist-downloader 网易云音乐 - 歌单/专辑/电台 - 下载器


🚨 项目来源

项目:https://github.com/magicdawn/yun-playlist-downloader


💡 项目特性

✅ 音质选择

✅ 下载超时 / 重试

✅ 再次下载默认跳过已下载部分, 使用 content-length 匹配

✅ 自定义文件名

✅ 下载进度显示


🔥 帮助文档

安装

1
$ npm i yun-playlist-downloader -g

使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
Usage: yun <url> [options]

位置:
url 歌单/专辑的链接 [字符串]

选项:
--retryTimeout 下载超时(分) [数字] [默认值: 3]
--retryTimes 下载重试次数 [数字] [默认值: 3]
--cover 下载封面 [布尔] [默认值: false]
--cookie cookie文件 [字符串] [默认值: "yun.cookie.txt"]
-h, --help 显示帮助信息 [布尔]
-v, --version 显示版本号 [布尔]
-c, --concurrency 同时下载数量 [数字]
-f, --format 文件格式 [字符串]
-q, --quality 音质 [数字]
-s, --skip 对于已存在文件且大小合适则跳过 [布尔]
-p, --progress 是否显示进度条 [布尔]

示例:
yun -c 10 <url> 10首同时下载
yun -f ":singer - :songName.:ext" <url> 下载格式为 "歌手 - 歌名"

帮助 & 文档: https://github.com/magicdawn/yun-playlist-downloader

--retry-timeout 重试超时

设置下载超时, 单位为分, 默认 3 分钟

--retry-times 重试次数

设置下载重试次数, 需要与 --retry-timeout 搭配使用,默认 3 次

--cover 下载封面

默认不下载

--cookie 已登录 cookie 存放地址

docs/cookie.md

-c, --concurrency 下载并发

下载并发

-f, --format 自定义文件名

token 含义 备注
:type = album or playlist
:typeText = 专辑 or 列表
:name 专辑名称 or 播放列表名称
:singer 歌手名
:songName 歌曲名(不含扩展名)
:ext 文件后缀,如 mp3 不带 .
:index 01 , 0212
:rawIndex 0 111
:programDate 电台节目发布日期 仅电台可用
:programOrder 数字, 电台第几期 仅电台可用

默认值 = :name/:singer - :songName.:ext 电台默认 = :name/:programDate 第:programOrder 期 - :songName.:ext

-q, --quality 自定义下载音质

取值 含义 备注
128 128kbits/s
192 192kbits/s
320 320kbits/s 默认

-s, --skip 是否跳过下载

  • 对于文件已存在, 而且文件大小与要下载的网络文件的 content-length 大小一致, 则跳过下载
  • 默认启用
  • 使用 --skip false 关闭该特性

-p, --progress 是否显示进度条

  • 默认 true, 显示进度条, 使用 false 不显示进度条
  • 使用了模块 ascii-progress, 问题比较多, 比如非 tty, 在控制台输入一些东西进度显示就乱了, 故提供选项关闭该特性

.yunrc

该工具使用了 rc 模块, 会去遍历读取 .yunrc 配置文件 具体规则见 rc 模块 README https://github.com/dominictarr/rc#standards


🔩 实际操作

  1. Node.js安装及环境配置之Windows篇 链接

    先安装node.js,因需要用到 npm 命令安装网易云音乐下载器,node.js默认会把npm安装好

  2. Windows系统Git安装教程(详解Git安装过程) 链接

    Git选装,不装Git也可以,只要安装好node.js,用系统 命令提示符 也可以

  3. 安装好上述程序后,开始在电脑上安装 网易云音乐下载器

    打开系统 命令提示符 ,按 Win + R 打开对话框,输入 CMD 打开命令提示符

    输入安装命令 : npm i yun-playlist-downloader -g

  1. 安装好 网易云音乐下载器 后,即可开始下载网易云歌单、专辑、电台.

    4.1 比如下载此歌单

1
https://music.163.com/#/playlist?id=7565912071

4.2 下载命令格式就是

1
2
yun < URL >   #格式
yun https://music.163.com/#/playlist?id=7565912071

4.3 下载到指定目录

需要安装 Git,安装 Git 参考步骤 2️⃣

在下载的目录下右击,选择 Git Bash Here ,弹出对话框

输入下载命令即可 yun < URL >


❓ 已知问题

  • 并发过大会导致某些一开始任务即便机器处于空闲状态也会 block 住, 请根据自己网速酌情设置 concurrency 参数
  • 使用了类似 Phantom.js 的 Nightmare 来计算下载参数, 安装的时候要装一遍 Electron, 程序体积比较大. 见谅.

☢ 更新记录

CHANGELOG.md