Skip to content

Latest commit

 

History

History
166 lines (141 loc) · 11.2 KB

README.org

File metadata and controls

166 lines (141 loc) · 11.2 KB
Raw

网易云音乐

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

./demo.png

依赖

  • 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

打赏

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