https://github.com/guanguans/music-dl
Music Searcher and Downloader. - 音乐搜索下载器。
https://github.com/guanguans/music-dl
command command-line-tool commandline download downloader music php search song
Last synced: 7 days ago
JSON representation
Music Searcher and Downloader. - 音乐搜索下载器。
- Host: GitHub
- URL: https://github.com/guanguans/music-dl
- Owner: guanguans
- License: mit
- Created: 2019-03-11T03:48:29.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-02-05T10:48:14.000Z (2 months ago)
- Last Synced: 2025-04-05T00:32:46.503Z (14 days ago)
- Topics: command, command-line-tool, commandline, download, downloader, music, php, search, song
- Language: PHP
- Homepage: https://guanguans.github.io/music-dl
- Size: 113 MB
- Stars: 697
- Watchers: 7
- Forks: 64
- Open Issues: 0
-
Metadata Files:
- Readme: README-zh_CN.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
- awesome-laravel-zero - Music DL
README
# music-dl
[简体中文](README-zh_CN.md) | [ENGLISH](README.md)
> Music Searcher and Downloader. - 音乐搜索下载器。
> :warning: 本工具仅用于学习交流，禁止将本工具用于商业用途，如产生法律纠纷与本人无关。
[](https://github.com/guanguans/music-dl/actions)
[](https://codecov.io/gh/guanguans/music-dl)
[](https://github.com/guanguans/music-dl/actions)
[](//packagist.org/packages/guanguans/music-dl)
[](//packagist.org/packages/guanguans/music-dl)
[](//packagist.org/packages/guanguans/music-dl)
## 环境要求
* PHP >= 8.2
## 安装
### 直接下载 [music-dl](./builds/music-dl) 文件
```shell
curl 'https://raw.githubusercontent.com/guanguans/music-dl/master/builds/music-dl' -o music-dl --progress-bar
chmod +x music-dl
```
### 通过 Composer 安装
```shell
composer global require guanguans/music-dl:dev-master --dev -v --ignore-platform-req=ext-pcntl # 全局
composer require guanguans/music-dl:dev-master --dev -v --ignore-platform-req=ext-pcntl # 本地
```
## 使用
```shell
╰─ ./music-dl list ─╯
Music DL refs/tags/4.1.6
USAGE: [options] [arguments]
completion Dump the shell completion script
inspire Display an inspiring quote
music Search and download music
self-update Allows to self-update a build application
thanks Thanks for using this tool.
```
```shell
╰─ ./music-dl music --help ─╯
Description:
Search and download music
Usage:
music [options] [--] []
Arguments:
keyword Search keyword for music
Options:
--driver[=DRIVER] Specify the search driver(sync、fork、process) [default: "sync"]
-d, --dir[=DIR] Specify the download directory
--no-continue Specify whether to recall the command after the download is complete
--sources[=SOURCES] Specify the music sources(tencent、netease、kugou) (multiple values allowed)
-h, --help Display help for the given command. When no command is given display help for the music command
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi|--no-ansi Force (or disable --no-ansi) ANSI output
-n, --no-interaction Do not ask any interactive question
--env[=ENV] The environment the command should run under
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
```
## 测试
```bash
composer test
```
## 变更日志
请参阅 [CHANGELOG](CHANGELOG.md) 获取最近有关更改的更多信息。
## 贡献指南
请参阅 [CONTRIBUTING](.github/CONTRIBUTING.md) 有关详细信息。
## 安全漏洞
请查看[我们的安全政策](../../security/policy)了解如何报告安全漏洞。
## 贡献者
* [guanguans](https://github.com/guanguans)
* [所有贡献者](../../contributors)
## 协议
MIT 许可证（MIT）。有关更多信息，请参见[协议文件](LICENSE)。