# vsc-netease-music

**Repository Path**: mirrors/vsc-netease-music

## Basic Information

- **Project Name**: vsc-netease-music
- **Description**: VSC Netease Music 是一个非官方的 Visual Studio Code 的网易音乐扩展
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 15
- **Forks**: 0
- **Created**: 2019-05-06
- **Last Updated**: 2025-08-01

## Categories & Tags

**Categories**: vsc-plugins

**Tags**: None

## README

<div align="center">

<img src="https://raw.githubusercontent.com/nondanee/vsc-netease-music/master/icon.png" alt="icon" width="128px">

# VSC Netease Music

**UNOFFICIAL** Netease Music extension for Visual Studio Code

[![Visual Studio Marketplace](https://img.shields.io/badge/Visual%20Studio-Marketplace-007acc.svg?style=flat-square)](https://marketplace.visualstudio.com/items?itemName=nondanee.vsc-netease-music)
[![Visual Studio Marketplace Version](https://img.shields.io/visual-studio-marketplace/v/nondanee.vsc-netease-music.svg?style=flat-square)](https://marketplace.visualstudio.com/items?itemName=nondanee.vsc-netease-music)
[![Visual Studio Marketplace Installs](https://img.shields.io/visual-studio-marketplace/i/nondanee.vsc-netease-music.svg?style=flat-square)](https://marketplace.visualstudio.com/items?itemName=nondanee.vsc-netease-music)
[![Visual Studio Marketplace Rating](https://img.shields.io/visual-studio-marketplace/stars/nondanee.vsc-netease-music.svg?style=flat-square)](https://marketplace.visualstudio.com/items?itemName=nondanee.vsc-netease-music)
[![GitHub Stars](https://img.shields.io/github/stars/nondanee/vsc-netease-music.svg?style=flat-square)](https://github.com/nondanee/vsc-netease-music)

![demo](https://user-images.githubusercontent.com/26399680/67140787-b22cbe80-f290-11e9-9d6a-77d50179de43.gif)

</div>

## Feature

使用 [Webview](https://code.visualstudio.com/api/extension-guides/webview) 实现，通过 [HTMLAudio​Element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement) 播放音乐，不依赖[命令行播放器](https://github.com/shime/play-sound#options)，**灵感来自 [kangping/video](https://marketplace.visualstudio.com/items?itemName=kangping.video)**

- 发现音乐 (歌单 / 新歌 / 排行榜)
- 搜索 (单曲 / 歌手 / 专辑 / 歌单 / 电台)
- 用户登录 (手机号 / 邮箱 / Cookie)
- 用户收藏 (歌单 / 歌手 / 专辑 / 电台)
- 每日歌曲推荐 / 推荐歌单 / 私人 FM / 心动模式 / 听歌排行
- 喜欢音乐 / 收藏音乐 (单曲 / 歌单 / 专辑 / 歌手 / 电台)
- 播放模式切换 / 音量调节
- 每日签到
- 逐行歌词
- 热门评论
- 快捷键支持
- 听歌记录
- 海外使用
- 支持 [Remote Development](https://code.visualstudio.com/docs/remote/remote-overview) / [code-server](https://github.com/cdr/code-server)

## Requirement

[VS Code 使用的 Electron 版本不包含 ffmpeg](https://stackoverflow.com/a/51735036)，需替换自带的 ffmpeg 动态链接库才能正常播放 (每次更新 VS Code 都需重新替换)

*VS Code for Windows 1.31.0 - 1.35.1 不需替换，1.36.0 后无此待遇*

*VS Code for macOS 1.43+ 替换后闪退[解决方案](https://github.com/nondanee/vsc-netease-music/issues/86#issuecomment-786546931)*

<details><summary>
<b>Manual Replacement</b>
</summary>

通过 VS Code 版本在 `https://raw.githubusercontent.com/Microsoft/vscode/%version%/.yarnrc` 查看其使用的 Electron 版本，并于 `https://github.com/electron/electron/releases/tag/%version%` 下载对应的 **Electron 完整版本**进行替换

#### Windows
下载 **electron-%version%-win32-%arch%.zip**

替换 `./ffmpeg.dll`

#### macOS
下载 **electron-%version%-darwin-x64.zip**

替换 `./Electron.app/Contents/Frameworks/Electron\ Framework.framework/Libraries/libffmpeg.dylib`

#### Linux
下载 **electron-%version%-linux-%arch%.zip**

替换 `./libffmpeg.so`

</details>

<details><summary>
<b>Automatic Replacement</b>
</summary>

使用 Python 脚本替换 (使用[淘宝 Electron 镜像](https://npm.taobao.org/mirrors/electron/)，兼容 Python 2/3，绝大部分发行版自带环境)

**默认安装位置下 Linux 和 Windows 需要以管理员身份运行，macOS 不需要**

#### Windows Powershell

```powershell
Invoke-RestMethod https://gist.githubusercontent.com/nondanee/f157bbbccecfe29e48d87273cd02e213/raw | python
```

#### Unix Shell

```
curl https://gist.githubusercontent.com/nondanee/f157bbbccecfe29e48d87273cd02e213/raw | python
```

如果 VS Code 使用默认配置安装，脚本会自动寻找并替换，若自定义了安装位置，请自行修改 [installation](https://gist.github.com/nondanee/f157bbbccecfe29e48d87273cd02e213#file-helper-py-L20)

</details>

## Usage

按下 <kbd>F1</kbd> 或 <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>P</kbd> 打开命令面板

输入命令前缀 `网易云音乐` 或 `NeteaseMusic` 开始探索 :D

## Hotkey

| Command     | Key                         |
| ----------- | --------------------------- |
| 静音 / 恢复 | <kbd>Alt</kbd> <kbd>M</kbd> |
| 上一首      | <kbd>Alt</kbd> <kbd>,</kbd> |
| 下一首      | <kbd>Alt</kbd> <kbd>.</kbd> |
| 播放 / 暂停 | <kbd>Alt</kbd> <kbd>/</kbd> |

## Extension Setting

* `NeteaseMusic.Popup.appearance`: 总是 / 仅失败时 / 从不显示 "正在播放" 提示
* `NeteaseMusic.API.SSL`: 启用 / 禁用 HTTPS API
* `NeteaseMusic.SSL.strict`: 启用 / 禁用 SSL 证书检查
* `NeteaseMusic.CDN.redirect`: 启用 / 禁用海外 CDN 重定向
* `NeteaseMusic.PIN.auto`: 启用 / 禁用自动固定 Webview 标签页

## Known Issue

- 由于未找到**支持播放在线音乐**、**能够正常遥控**又**足够小巧**的命令行播放器而借助 Webview 实现 ([mpg123 在 windows 下的控制有 bug](https://sourceforge.net/p/mpg123/mailman/mpg123-users/thread/CAN5OgQWuYFt4mbbjDZcxMMdTQLZoNiF8AgH5S8Z8rwraN%2B65uA%40mail.gmail.com/))
- 暂不支持分页 (组件的交互限制)
- 图标不合适 ([等 VS Code 增加更多图标支持](https://github.com/Microsoft/vscode/issues/10455))
- 列表对齐可能有问题 (不同字体下字符宽度不等)
- Webview 标签无法隐藏，使用时请不要关闭标签
- ~~[Webview API 限制只在前台可见才能接收来自插件侧的 postMessage 消息](https://code.visualstudio.com/api/references/vscode-api#Webview)，需要通信时插件会自动切换到 Webview 再复原 Editor，标签切换不可见但会引起编辑器滚动条闪动 (不影响输入)~~ ~~自 1.31.0 开始 reveal 后 postMessage 会导致可见的切换延迟，已改用 WebSocket 实现双向通信~~ ~~因 [WebSocket 端口无法转发](https://code.visualstudio.com/api/references/vscode-api#WebviewOptions)导致在 remote 环境无法使用，已改为 SSE + postMessage 实现~~ 自 1.35.0 开始，[后台 Webview 可以接收 postMessage 消息](https://code.visualstudio.com/updates/v1_35#_webviews-that-set-retaincontextwhenhidden-can-now-receive-messages-when-in-the-background)，改回自带 postMessage 实现双向通信
- 1.31.0 升级使用 Electron 3.x，受制于 [Chrome 66 内核的 Autoplay Policy](https://developers.google.com/web/updates/2017/09/autoplay-policy-changes)，用户需先与 Webview 交互才能播放
- ~~播放列表较长时无法定位到当前播放歌曲 (VS Code 未实现 activeItems 处于 quickPick 非可视区域时的滚动聚焦)~~ 长列表定位问题 VS Code 已修复
- 只显示中文命令是因为使用中文系统语言而未装中文语言包，应是 VS Code 对 nls 支持的 bug，请在应用商店安装中文语言包。如果习惯英文的话，可将显示语言改回英文