yun-playlist-downloader

网易云音乐 - 歌单 - 下载器
notion image
notion image
notion image
notion image
notion image
notion image

特性

  • 支持歌单 / 专辑 / 电台
  • 音质选择
  • 下载超时 / 重试
  • 再次下载默认跳过已下载部分, 使用 content-length 匹配
  • 自定义文件名
  • 下载进度显示

安装

# pnpm (recommend)
$ pnpm add -g yun-playlist-downloader

# npm
$ npm i yun-playlist-downloader -g

使用

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 下载封面

默认不下载

c, --concurrency 下载并发

下载并发

f, --format 自定义文件名

token
含义
备注
:type
= album or playlist
:typeText
= 专辑 or 列表
:name
专辑名称 or 播放列表名称
:singer
歌手名
:songName
歌曲名(不含扩展名)
:ext
文件后缀,如 mp3 不带 .
:index
01 , 02 ... 12
:rawIndex
0 1 ... 11
: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, 在控制台输入一些东西进度显示就乱了, 故提供选项关闭该特性

截图

notion image

已知问题

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