azusa: A JavaScript repository from 可愛實驗室

🎇 让可爱填满你的播放器(误

Introduction

这个是用来帮助将你的网易云曲库搬到播放器的小程序，经过多次重构现已进入稳定状态，在 NW-ZX300 上亲测可正常使用

Feature

同步收藏的歌单/歌手/专辑
自动填充文件元数据
生成歌词及翻译
多线程下载
为本地文件夹生成播放列表
本地化 NeteaseCloudMusicApi / 无依赖
可同步播放器端对歌单的修改
支持日推 / 历史日推下载

Usage

Pre-build version

前往 release 下载对应操作系统架构的包
在播放器 /MUSIC 的同级目录创建文件夹 Azusa 或在 /MUSIC 目录同级目录克隆本项目
将 config.example.js 重命名为 config.js 并按照 Configuration 小节的指示修改并保存
打开命令行执行(Unix)或直接双击软件包运行程序
Enjoy~

Dev version

直接在播放器 /MUSIC 的同级目录克隆本项目，进入后输入 npm install 安装依赖
同上小节 3.
输入 npm start 运行程序
Enjoy~

Configuration

module.exports = {
  // 日志等级
  logLevel: 'info',

  // 是否为 /MUSIC 目录中的文件夹生成播放列表
  generatePlaylistFile: false,

  // 网易云手机账号
  phone: 13912345678,
  // 网易云密码
  password: '1234567',
  // 是否保存 Cookie
  saveCookie: true,

  // 附加的歌单
  extraPlaylist: [
    12345,
    23345
  ],
  // 排除的歌单
  excludePlaylist: [],
  // 需要同步的歌单
  syncPlaylist: [
    233333,
    'all' // 当数组中存在字符串 all 时，程序会将所有可编辑的歌单添加到监控列表中
  ],

  // 是否下载收藏的专辑
  downloadSubAlbum: false,
  // 附加的专辑
  extraAlbum: [],
  // 排除的专辑
  excludeAlbum: [],

  // 是否下载收藏的歌手热门歌曲
  downloadSubArtist: false,
  // 下载的歌曲数量 (前 N 首)
  downloadSubArtistTopNum: 30,
  // 附加的歌手
  extraArtist: [],
  // 排除的歌手
  excludeArtist: [],

  // 下载当日日推
  downloadRecommendation: false,
  // 下载历史日推 (仅限黑胶 VIP )
  downloadHistoryRecommendation: false,

  // 下载音质
  bitRate: 999000,

  // 是否将歌词与翻译合并为一行
  mergeTranslation: false,

  // 播放列表前缀
  prefix: {
    album: '[Album] ',
    artistTopN: '[Artist Top $] ',
    playlist: '[Playlist] ',
    userDir: '[Dir] ',
    recommendation: '[Recommendation] '
  }
}

Function Description

Flow

为本地目录创建播放列表文件 -> 登录&获取歌单列表&处理播放器端播放列表变动 -> 下载音乐及歌词至播放器&异步写入播放列表文件

Save Cookie

开启后运行时会在根目录下生成 account.json 用于存放账号 Cookie

Generate Playlist File

为本地 /MUSIC 目录下已有的目录中的文件生成播放列表文件，与文件夹同名

Sync Playlist

添加在这个列表中的播放列表会被程序监测并处理变动，用户必须有该播放列表的修改权限

逻辑: 生成播放列表时保存两份(一份 m3u 一份 JSON)，当播放器端进行更改(增加或删除曲目)时会对 m3u 文件进行修改，程序通过比对得到需要更改的项目

Merge Translation

据反馈(#1)某些机器不支持多行同时间歌词，开启次开关后程序会将原文及翻译整合为一行

SensMe & Music Center for PC Support

本项目可和 Sony 官方的 Music Center for PC 配合使用，后者可为播放器中的音乐补全风格等元信息并可将歌曲加入 Sony 播放器中的 SensMe 频道

打开 Music Center for PC，在 文件 -> 导入文件夹 中选择播放器的 MUSIC/Azusa 文件夹，全选右键点击 获取未知元素 即可开始填充进程

Credit

Illustration: あずにゃん

Name

Azusa Nakano from K-On!

LICENSE

MIT

KawaiiLab/azusa