guanguans/music-php

Music Searcher and Downloader. - 音乐搜索下载器。

Maintainers

👁 guanguans

Package info

github.com/guanguans/music-dl

Type:project

pkg:composer/guanguans/music-php

Fund package maintenance!

Sponsors

Statistics

Installs: 1 106

Dependents: 0

Suggesters: 0

Stars: 746

Open Issues: 0

7.0.2 2026-04-13 07:11 UTC

Requires

Requires (Dev)

Suggests

  • ext-pcntl: Required for the fork driver

Provides

None

Conflicts

None

Replaces

None

MIT da35ea5d2a09ff0ca2f104b4bdf85fc36e05158b

searchmusicdownloadsongdl

This package is auto-updated.

Last update: 2026-06-27 11:42:28 UTC


README

👁 usage

简体中文 | ENGLISH

Music Searcher and Downloader. - 音乐搜索下载器。

⚠️ This tool is only used for learning and communication. It is forbidden to use this tool for commercial purposes. If a legal dispute arises, it has nothing to do with me.

👁 tests
👁 php-cs-fixer
👁 codecov
👁 Latest Stable Version
👁 GitHub release (with filter)
👁 Total Downloads
👁 License

Requirement

  • PHP >= 8.5

Installation

Download the music-dl file

curl 'https://raw.githubusercontent.com/guanguans/music-dl/master/builds/music-dl' -o music-dl --progress-bar
chmod +x music-dl

Install via Composer

composer global require guanguans/music-dl:dev-master --dev -v --ignore-platform-req=ext-pcntl # global
composer require guanguans/music-dl:dev-master --dev -v --ignore-platform-req=ext-pcntl # local

Usage

╰─ ./music-dl list ─╯

 Music DL refs/tags/6.2.5

 USAGE: <command> [options] [arguments]

 completion Dump the shell completion script
 inspire Display an inspiring quote
 music Search and download music
 self-update Self-update the installed application
 thanks Thanks for using this tool.
╰─ ./music-dl music --help ─╯
Description:
 Search and download music

Usage:
 music [options] [--] [<keyword>]

Arguments:
 keyword Search keyword for music

Options:
 -b, --break Specify whether to break after download
 -d, --directory[=DIRECTORY] Specify the download directory
 -D, --driver[=DRIVER] Specify the search driver(sync、fork、process)
 -l, --locale[=LOCALE] Specify the locale language [default: "zh_CN"]
 -N, --no-notify Specify whether to disable desktop notification
 -p, --page[=PAGE] Specify the page number [default: "1"]
 -P, --per-page[=PER-PAGE] Specify the per page number [default: "30"]
 -s, --sources[=SOURCES] Specify the music sources(tencent、netease、kugou) (multiple values allowed)
 --isolated[=ISOLATED] Do not run the command if another instance of the command is already running [default: false]
 --xdebug Display xdebug output
 --configuration[=CONFIGURATION] Used to dynamically pass one or more configuration key-value pairs(e.g. `--configuration=app.name=guanguans`). (multiple values allowed)
 -h, --help Display help for the given command. When no command is given display help for the music command
 --silent Do not output any message
 -q, --quiet Only errors are displayed. All other output is suppressed
 -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

👁 usage

Composer scripts

composer checks:required
composer php-cs-fixer:fix
composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.