netease-cloud-music.el

netease-cloud-music.el copied to clipboard

• 网易云音乐 网易云音乐是一个可以让你在 Emacs 里听音乐的插件 (请认真看完本文档，本文档为 TUI 端文档) [[file:./README-eaf.org][EAF端文档]]

  [[./demo.png]] ** 依赖

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

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

  • ~request~

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

  • ~socat~

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

  1. 克隆此仓库 #+begin_src shell git clone https://github.com/SpringHan/netease-cloud-music.el.git ~/.emacs.d/ --depth=1 #+end_src

  2. 添加至 ~init.el~: #+begin_src emacs-lisp ;; 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 #+end_src ** 可选功能

  3. ~netease-cloud-music-ui~

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

     #+begin_src emacs-lisp (require 'netease-cloud-music-ui) #+end_src

  4. ~netease-cloud-music-comment~

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

     #+begin_src emacs-lisp (require 'netease-cloud-music-comment) #+end_src

     注意：评论功能需要额外安装 ~async~ 包 ** 快捷键 | 快捷键 | 功能 | |--------+-------------------------------------------------------------------------------------------------| | g | 跳转到指定位置或者切换歌单、播放歌曲 | | s | 保存当前歌单至本地缓存文件 | | u | 通过用户ID获取其歌单 | | d | 删除当前光标下歌曲 | | w | 进入编辑模式 | | / | 通过搜索的方式播放本地歌单 | | | 将当前歌曲向上移动 | | | 将当前歌曲向下移动 | | 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"~

    更多可用的命令[[https://github.com/SpringHan/netease-cloud-music.el/issues/3][见这里]].

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

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

    #+begin_src emacs-lisp (setq netease-cloud-music-player-command '("mpv" "pause\n" "seek 5" "seek -5")) #+end_src

  • ~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]]