/mxget

优雅的一站式音乐搜索、下载试听服务,支持国内所有音乐平台

Primary LanguageGoGNU General Public License v3.0GPL-3.0

mxget

通过命令行在线搜索你喜欢的音乐,下载并试听。

Python版:pymxget

Actions Status Actions Status

功能特性

  • 聚合国内各大音乐平台的资源,支持在线搜索和下载试听。
  • 单曲、专辑、歌单以及歌手热门歌曲,只需一步,就能搞定!
  • 支持自动嵌入音乐标签/下载歌词。
  • 利用Goroutines的先天优势快速并发下载。
  • 支持库调用和RESTful API。

重要说明

mxget 开发的初衷只是免去你须要频繁在各大网站切换听歌的烦恼,而不是为了破解音乐平台的数字版权限制。它无法下载受版权保护的数字音乐,音频也仅提供标准音质(128kbps)下载。如果你喜欢高音质/无损资源,请支持正版。

任何组织/个人不得将本项目用于商业或者其它非法用途,因此造成的责任和风险由使用者自行承担!

支持的音乐平台

音乐平台 平台标识 专用识别码
网易云音乐 netease / nc 1000
QQ音乐 tencent / qq 1001
咪咕音乐 migu / mg 1002
酷狗音乐 kugou / kg 1003
酷我音乐 kuwo / kw 1004
虾米音乐 xiami / xm 1005
千千音乐 qianqian / baidu / bd 1006

下载安装

go get -u github.com/winterssy/mxget

使用帮助

本项目不提供可执行程序下载,如须开箱即用,可选择 pymxget

 _____ ______      ___    ___ ________  _______  _________   
|\   _ \  _   \   |\  \  /  /|\   ____\|\  ___ \|\___   ___\ 
\ \  \\\__\ \  \  \ \  \/  / | \  \___|\ \   __/\|___ \  \_| 
 \ \  \\|__| \  \  \ \    / / \ \  \  __\ \  \_|/__  \ \  \  
  \ \  \    \ \  \  /     \/   \ \  \|\  \ \  \_|\ \  \ \  \ 
   \ \__\    \ \__\/  /\   \    \ \_______\ \_______\  \ \__\
    \|__|     \|__/__/ /\ __\    \|_______|\|_______|   \|__|
                  |__|/ \|__|                                

A simple tool that help you search and download your favorite music,
please visit https://github.com/winterssy/mxget for more detail.

Usage:
  mxget [command]

Available Commands:
  album       Fetch and download album's songs via its id
  artist      Fetch and download artist's hot songs via its id
  config      Specify the default behavior of mxget
  help        Help about any command
  playlist    Fetch and download playlist's songs via its id
  search      Search songs from the specified music platform
  serve       Run mxget as an API server
  song        Fetch and download single song via its id

Flags:
  -h, --help      help for mxget
      --version   version for mxget

Use "mxget [command] --help" for more information about a command.

作为CLI使用

这是 mxget 的基础功能,你可以通过终端调用 mxget 实现音乐搜索、下载功能。以网易云音乐为例,

  • 搜索歌曲
$ mxget search --from nc -k Faded

如果你的搜索关键词包含空格,请用双引号 "" 包围起来。

  • 下载歌曲
$ mxget song --from nc --id 36990266
  • 下载专辑
$ mxget album --from nc --id 3406843
  • 下载歌单
$ mxget playlist --from nc --id 156934569
  • 下载歌手热门歌曲
$ mxget artist --from nc --id 1045123
  • 自动更新音乐标签/下载歌词

如果你希望 mxget 为你自动更新音乐标签,可使用 --tag 指令,如:

$ mxget song --from nc --id 36990266 --tag

当使用 --tag 指令时,mxget 会同时将歌词内嵌到音乐文件中,一般而言你无须再额外下载歌词。如果你确实需要 .lrc 格式的歌词文件,可使用 --lyric 指令,如:

$ mxget song --from nc --id 36990266 --lyric
  • 设置默认下载目录

默认情况下,mxget 会下载音乐到当前目录下的 downloads 文件夹,如果你想要更改此行为,可以这样做:

$ mxget config --dir <directory>

directory 必须为绝对路径。

  • 设置默认音乐平台

mxget 默认使用的音乐平台为网易云音乐,你可以通过以下命令更改:

$ mxget config --from qq

这样,如果你不通过 --from 指令指定音乐平台,mxget 便会使用默认值。

在上述命令中,你会经常用到 --from 以及 --id 这两个指令,它们分别表示音乐平台标识和音乐id。

音乐id为音乐平台为对应资源分配的唯一id,当使用 mxget 进行搜索时,歌曲id会显示在每条结果的后面。你也可以通过各大音乐平台的网页版在线搜索相关资源,然后从结果详情页的URL中获取其音乐id。值得注意的是,酷狗音乐对应的歌曲id即为文件哈希 hash

  • 多任务下载

mxget 支持多任务快速并发下载,你可以通过 --limit 参数指定同时下载的任务数,如不指定默认为CPU核心数。

$ mxget playlist --from nc --id 156934569 --limit 16

尽管 mxget 允许设置的最高并发数是32,但使用时建议不要超过16,请根据网络状况适当调整。

作为库调用

mxget 封装了一些便捷的API,Go开发者可以直接调用,举个例子:

package main

import (
	"context"
	"fmt"

	"github.com/winterssy/mxget/pkg/provider/netease"
)

func main() {
	client := netease.New(nil)
	resp, err := client.GetSong(context.Background(), "36990266")
	if err != nil {
		panic(err)
	}

	fmt.Println(resp)
}

Tip:使用前你须对作者开发的另一款网络请求库 sreq 有所了解,更多细节请阅读 mxget 的源码。

网易云音乐API的加解密算法参考 Binaryify/NeteaseCloudMusicApi 并用Golang实现,但 mxget 并未移植原项目的所有API,如开发者需要,可fork本项目实现,很简单。

作为API服务部署

mxget 提供了简易的RESTful API,允许你基于其开发web应用。启动服务:

$ mxget serve

Docker版:

$ docker pull winterssy/mxget
$ docker run -d --name mxget -p 8080:8080 -p 8090:8090 winterssy/mxget

注:8090 为 grpc 端口,rpc 相关功能目前还在探索开发中。pymxget 不支持 rpc 。

请求方法均为 GET ,统一调用路径为 /api/{platform}/{type}/{param} ,示例:

  • 从QQ音乐获取 周杰伦 的搜索结果
$ curl -X GET "http://127.0.0.1:8080/api/qq/search/周杰伦" -H "accept: application/json"
  • 从网易云音乐获取id为 36990266 的歌曲资源
$ curl -X GET "http://127.0.0.1:8080/api/netease/song/36990266" -H "accept: application/json"
  • 从咪咕音乐获取id为 1121438701 的专辑资源
$ curl -X GET "http://127.0.0.1:8080/api/migu/album/1121438701" -H "accept: application/json"
  • 从酷狗音乐获取id为 547134 的歌单资源
$ curl -X GET "http://127.0.0.1:8080/api/kugou/playlist/547134" -H "accept: application/json"
  • 从酷我音乐获取id为 336 的歌手资源
$ curl -X GET "http://127.0.0.1:8080/api/kuwo/artist/336" -H "accept: application/json"

注: 由于音乐平台的限制,mxget 的API服务仅在本地测试通过。如果你将 mxget 部署到公网,特别是海外VPS上,开发者不保证能工作,遇到的问题需要你自行解决。

FAQ

  • 抓取(Fetch)歌单数据耗时较长?

mxget 会将音乐标签、歌词等内容聚合之后才返回数据,耗时时长跟歌单歌曲数成正比。

  • 为什么部分音乐不支持下载?

API请求本身没有返回相应数据,原因可能是音乐平台的版权限制,这不是开发者能够解决的,请尝试更换音乐平台。

  • 下载MV?

经过调研,mxget 已明确不支持下载MV。

免责声明

  • 本项目仅供学习研究使用。
  • 本项目使用的接口如无特别说明均为官方接口,音乐版权归源音乐平台所有,侵删。

License

GPLv3。