Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zonemeen/musicn
🎵 一个可播放及下载音乐的 Node.js 命令行工具
https://github.com/zonemeen/musicn
163music cli cli-tools command-line command-line-tool free free-download music music-download music-downloader netease-cloud-music netease-music node-tool nodejs
Last synced: 21 days ago
JSON representation
🎵 一个可播放及下载音乐的 Node.js 命令行工具
- Host: GitHub
- URL: https://github.com/zonemeen/musicn
- Owner: zonemeen
- License: mit
- Created: 2021-08-25T08:05:14.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-15T12:58:05.000Z (8 months ago)
- Last Synced: 2024-10-15T23:41:23.966Z (24 days ago)
- Topics: 163music, cli, cli-tools, command-line, command-line-tool, free, free-download, music, music-download, music-downloader, netease-cloud-music, netease-music, node-tool, nodejs
- Language: TypeScript
- Homepage:
- Size: 1 MB
- Stars: 1,628
- Watchers: 11
- Forks: 156
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- StarryDivineSky - zonemeen/musicn
README
# Musicn
🎵 一个可播放及下载音乐的 Node.js 命令行工具
## 全局安装
```bash
$ npm i musicn -g
# or
$ yarn global add musicn
```
容器形式部署安装可以参考：[musicn-container](https://github.com/wy580477/musicn-container)
## 使用
```bash
$ musicn 周杰伦
# or
$ msc 周杰伦
```
### 帮助信息:
```bash
$ msc --help
# or
$ msc -h
```
### 开启本地播放链接(手机可扫描二维码)下载及播放:
```bash
$ msc --qrcode
# or
$ msc -q
# or
$ msc -q -P 3000 # 指定端口，-P为大写
```
> 注意：使用手机扫描二维码时，电脑和手机两个设备必须连接到同一个 Wi-Fi；强烈推荐这种方式，既能听歌又能下载歌曲
也可以部署到自己的服务器，具体方法如下：
```shell
git clone https://github.com/zonemeen/musicn.git
cd musicn
npm install
npm run build
node ./bin/cli.js -q
# or
pm2 start ./bin/cli.js --name music-app -- -q
```
### 开启本地播放链接是否自动打开浏览器:
```bash
$ msc -q --open
# or
$ msc -q -o
```
### 搜索的页码数(默认是第1页):
```bash
$ msc 周杰伦 --number 2
# or
$ msc 周杰伦 -n 2
# or
$ msc -n 2 周杰伦
```
### 搜索的歌曲数量(默认是20条):
```bash
$ msc 周杰伦 --size 10 -w # wangyi的服务
# or
$ msc 周杰伦 -s 10 -w
# or
$ msc -s 10 -w 周杰伦
```
> 注意：咪咕正常搜索因为api不支持，搜索时的自定义歌曲数量是无效的
### 咪咕服务下载(默认是这个服务):
```bash
$ msc 周杰伦
```
### 网易云服务下载:
```bash
$ msc 周杰伦 --wangyi
# or
$ msc 周杰伦 -w
# or
$ msc -w 周杰伦
```
### 酷狗服务下载:
```bash
$ msc 周杰伦 --kugou
# or
$ msc 周杰伦 -g
# or
$ msc -g 周杰伦
```
### 根据歌单id下载:
```bash
$ msc --songListId 206140403
# or
$ msc -i 206140403
# or
$ msc -i 206140403 -n 2
```
### 自定义下载路径(默认是当前路径):
```bash
$ msc 周杰伦 --path ../music
# or
$ msc 周杰伦 -p ../music
# or
$ msc -p ../music 周杰伦
```
> 开启本地播放链接时附带此参数，可通过 web 页面下载音乐至服务器对应 path
### 自定义base URL(默认为空):
```bash
$ msc 周杰伦 -q --base musicn
# or
$ msc 周杰伦 -q -b musicn
```
> 注意：只应用在开启本地播放链接时且首尾不能是 `/`，最终呈现的 URL `http://192.168.0.204:7478/musicn`
### 附带歌词下载(默认是不附带):
```bash
$ msc 周杰伦 --lyric
# or
$ msc 周杰伦 -l
# or
$ msc -l 周杰伦
```
> 开启本地播放链接时附带此参数，可通过 web 页面下载歌词至服务器对应 path（需结合 path 使用）
### 版本信息:
```bash
$ msc --version
# or
$ msc -v
```
## 资源
- 音乐来源: 咪咕、酷狗和网易云（API 是从公开的网络中获得）
## 说明
1. 暂时只支持咪咕、酷狗和网易云的服务（因一些特殊原因，其余平台暂时是不支持的，所有服务暂时也只支持普通mp3格式的下载及播放，且部分服务的会员专属歌曲下载暂时也不支持，后期会继续探索其余平台可用的音乐下载）
2. 在 `windows` 桌面端的 `git Bash` 中不支持上下切换选歌，问题是 `inquirer` 不兼容，建议使用其它终端工具
3. node version > 16
4. 此项目仅供个人学习研究，严禁用于商业用途