Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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 命令行工具

Awesome Lists containing this project

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. 此项目仅供个人学习研究,严禁用于商业用途