SpringHan / netease-cloud-music.el

A netease music client for emacs.

网易云音乐

网易云音乐是一个可以让你在 Emacs 里听音乐的插件 (请认真看完本文档，本文档为 TUI 端文档) EAF端文档

依赖

• mpv 或者其他能够播放在线音乐、快进快退、暂停歌曲的播放器

  这是一个播放歌曲的播放器 如果你是一名 Arch 用户, 你可以用这条命令安装它: sudo pacman -S mplayer

• request

  这是一个 Emacs 包裹, 你能用 M-x package-install RET request RET 安装它

• socat

  这是一个与进程有关的程序，如果你使用 mpv 作为播放器、且你的操作系统不是 Windows ，你就必须安装这个软件。

安装

1. 克隆此仓库

   git clone https://github.com/SpringHan/netease-cloud-music.el.git ~/.emacs.d/ --depth=1
       

2. 添加至 init.el:

   ;; Add it to load path
   (add-to-list 'load-path "/path/to/netease-cloud-music.el")
   
   ;; Require it
   (require 'netease-cloud-music)
   (require 'netease-cloud-music-ui)       ;If you want to use the default TUI, you should add this line in your configuration.
   (require 'netease-cloud-music-comment)  ;If you want comment feature
       

可选功能

1. netease-cloud-music-ui

   如果你想使用 TUI ，则需要在配置里加入：

   (require 'netease-cloud-music-ui)
       

2. netease-cloud-music-comment

   如果你想使用评论功能，则需要在配置里加入：

   (require 'netease-cloud-music-comment)
       

   注意：评论功能需要额外安装 async 包

快捷键

快捷键	功能
g	跳转到指定位置或者切换歌单、播放歌曲
s	保存当前歌单至本地缓存文件
u	通过用户ID获取其歌单
d	删除当前光标下歌曲
w	进入编辑模式
/	通过搜索的方式播放本地歌单
<up>	将当前歌曲向上移动
<down>	将当前歌曲向下移动
r	更改repeat mode
d	将光标下的歌曲从列表删除
f	搜索歌曲
F	搜索歌单
P	播放播放列表中的所有歌曲
p	上一首或移动光标到上一行
n	下一首或移动光标到下一行
N	随机播放下一首
x	停止当前歌曲
c	切换歌词模式 (原歌词、双语歌词、无歌词)
C	创建用户歌单
m	更改光标下歌单名称
M	删除用户歌单
k	清空当前歌单
l	登陆
>	快进
<	快退
?	帮助文档
h	帮助文档
RET	播放光标下音乐或将光标下歌单设置为当前歌单
SPC	暂停或继续当前歌曲
TAB	将光标下的用户歌单展开显示其歌曲
q	返回打开网易云音乐前的 buffer
Q	退出网易云音乐
e	获取每日推荐歌曲 (显示后添加方式与搜索歌曲的相同)
E	获取每日推荐歌单 (显示后添加方式与搜索歌曲的相同)
j	将光标下歌曲添加入 storage (若光标下无歌曲，将询问用户是将当前播放歌曲还是当前歌单加入 storage)
J	将 storage 中歌曲加入到当前歌单
o	显示 storage 中歌曲
K	清空 storage
R	打开评论

选择模式快捷键

快捷键	功能
q	关闭选择窗口
n	下一行
p	上一行 (song 和 playlist 通用) 或 将歌单歌曲替换为搜索结果 (for song)
f	下一页结果
b	上一页结果
d	从 storage 删除光标下歌曲
RET	将歌曲加入到本地歌单 (for song) 或 将歌单中歌曲加入到当前歌单 (for playlist)
TAB	将光标下的歌单展开显示其歌曲 (for playlist)
P	将当前歌单替换为搜索到的一定页数的歌曲 (for song)
a	将当前页搜索到的歌曲加入到当前歌单 (for song) 或将本页所有歌单搜索结果加入到当前歌单 (for playlist)
A	将搜索到的一定页数的歌曲加入到当前歌单 (for song)

编辑模式快捷键

快捷键	功能
C-c C-c	保存更改
C-c C-k	取消更改

评论模式快捷键

快捷键	功能
q	退出当前评论
x	暂时关闭当前评论 buffer
n	下一行 或 加载更多评论 (当在 point-max 执行时)
p	上一行
c	复制 cursor 下评论的内容
R	发表评论
g	到达首行
G	到达尾行

评论发送的编辑模式快捷键

快捷键	功能
C-c C-c	发送评论
C-c C-k	取消评论

函数

• netease-cloud-music

  可通过此函数打开网易云音乐buffer。如果已经打开，则跳转到网易云音乐buffer。

• netease-cloud-music-change-repeat-mode

  可通过此函数开启关闭循环模式。

变量

• netease-cloud-music-player-command (list)

  这个函数的值包括：播放器的命令、继续播放的进程信息、停止播放的进程信息、快进进程信息、快退进程信息。

  默认值： ~’(“mpv” “pause\n” “seek 5” “seek -5”)~

  如果你是 Windows 系统用户，播放器命令后应加上 .exe ，示例： ~”mpv.exe”~

  更多可用的命令见这里.

  如果你使用 mplayer 作为你的音乐播放器，那么你不需要花时间配置这个变量。

  提示：你可以在快进快退的进程信息里定义它的秒数，下面是个例子：

  (setq netease-cloud-music-player-command '("mpv" "pause\n" "seek 5" "seek -5"))
      

• netease-cloud-music-buffer-name (String)

  你可以通过改变这个变量的值从而设置网易云音乐的buffer。默认值：~”Netease-Cloud-Music”~

注意

1. 本客户端初次启动歌单空是正常情况，添加歌曲或者登陆之后便有歌曲可听。
2. 本客户端用户功能等需要用到第三方 API ，如果没有此需求可以不下载。若要下载则使用 (netease-cloud-music-donwload-api) 进行下载。
3. 本客户端登陆时密码会自动使用 MD5 加密，初次登陆后手机号和密码信息会储存在本地缓存文件，下一次直接自动登陆。
4. 在添加歌曲到用户歌单后，同步远程的歌单可能需要时间，这为正常现象。
5. 目前本插件还不支持 Windows 系统下的快进、快退 (如果使用 mpv )，原因是 Windows 使用的是 Named Pipe。

许可

GPL-3.0

打赏

如果觉得本项目还不错的话，欢迎打赏。