PHPackages guanguans/music-php - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Search & Filtering](/categories/search) 4. / 5. guanguans/music-php ActiveProject[Search & Filtering](/categories/search) guanguans/music-php =================== Music Searcher and Downloader. - 音乐搜索下载器。 7.0.2(3w ago)7461.1k67MITPHPPHP >=8.5CI passing Since May 23Pushed 1mo ago5 watchersCompare [ Source](https://github.com/guanguans/music-dl)[ Packagist](https://packagist.org/packages/guanguans/music-php)[ Docs](https://github.com/guanguans/music-dl)[ Fund](https://guanguans.github.io/sponsors)[ RSS](/packages/guanguans-music-php/feed)WikiDiscussions master Synced today READMEChangelog (10)Dependencies (121)Versions (152)Used By (0) music-dl ======== [](#music-dl) [![usage](resources/images/music-dl.gif "usage")](resources/images/music-dl.gif) [简体中文](README-zh_CN.md) | [ENGLISH](README.md) > 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](https://github.com/guanguans/music-dl/workflows/tests/badge.svg)](https://github.com/guanguans/music-dl/actions)[![codecov](https://camo.githubusercontent.com/285c1dd95eea58bdf4b9d6acb819c46e2732fa45c186553e039cb239ae7d7ba3/68747470733a2f2f636f6465636f762e696f2f67682f6775616e6775616e732f6d757369632d646c2f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d4a61353153635974484e)](https://codecov.io/gh/guanguans/music-dl)[![check & fix styling](https://github.com/guanguans/music-dl/actions/workflows/php-cs-fixer.yml/badge.svg)](https://github.com/guanguans/music-dl/actions)[![Latest Stable Version](https://camo.githubusercontent.com/131accdd8ccbe972431979a20a72c77bcce429e2e42480e11b319ab06791a1f1/68747470733a2f2f706f7365722e707567782e6f72672f6775616e6775616e732f6d757369632d646c2f76)](//packagist.org/packages/guanguans/music-dl)[![GitHub release (latest by date)](https://camo.githubusercontent.com/28aa1ee6f51582c24c8c550377a96308a5d47c35d49de726efbb7b1d1ae8cdf1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6775616e6775616e732f6d757369632d646c)](https://camo.githubusercontent.com/28aa1ee6f51582c24c8c550377a96308a5d47c35d49de726efbb7b1d1ae8cdf1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6775616e6775616e732f6d757369632d646c)[![Total Downloads](https://camo.githubusercontent.com/e2de260b3f9231c87a563624dbda97f885717608241f9028ac3e98ce0b7022b4/68747470733a2f2f706f7365722e707567782e6f72672f6775616e6775616e732f6d757369632d646c2f646f776e6c6f616473)](//packagist.org/packages/guanguans/music-dl)[![License](https://camo.githubusercontent.com/69704796a6fb561afff67074f8f7b557f5c508b842227adef1978fb77aefc64d/68747470733a2f2f706f7365722e707567782e6f72672f6775616e6775616e732f6d757369632d646c2f6c6963656e7365)](//packagist.org/packages/guanguans/music-dl) Requirement ----------- [](#requirement) - PHP >= 8.4 Installation ------------ [](#installation) ### Download the [music-dl](./builds/music-dl) file [](#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 [](#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 ----- [](#usage) ``` ╰─ ./music-dl list ─╯ Music DL refs/tags/6.2.5 USAGE: [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] [--] [] 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](resources/images/music-dl.gif)](resources/images/music-dl.gif) Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [guanguans](https://github.com/guanguans) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE) for more information. ### Health Score 63 — FairBetter than 99% of packages Maintenance80 Actively maintained with recent releases Popularity38 Limited adoption so far Community23 Small or concentrated contributor base Maturity95 Battle-tested with a long release history Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~18 days Recently: every ~46 days Total 136 Last Release 27d ago Major Versions 2.x-dev → v3.0.0-beta12022-03-18 3.x-dev → 4.0.02023-11-23 4.3.1 → 5.0.02024-05-24 5.x-dev → 6.0.02025-09-15 6.x-dev → 7.0.02026-04-04 PHP version history (10 changes)v1.0.0PHP >=5.5.9 v1.0.1PHP >=7.1 v1.1.0PHP >=5.6 v3.0.0-beta1PHP ^8.0 v3.4.0PHP >=8.0 4.0.0PHP >=8.1 5.0.0PHP >=8.2 6.0.0PHP >=8.3 6.1.0PHP >=8.4 7.0.0PHP >=8.5 ### Community Maintainers ![](https://www.gravatar.com/avatar/a49e4a0625bdf47c4e2924dcf07a053538d0c3a1e9287e8d6bfe68ed4017aa6f?d=identicon)[guanguans](/maintainers/guanguans) --- Top Contributors [![guanguans](https://avatars.githubusercontent.com/u/22309277?v=4)](https://github.com/guanguans "guanguans (901 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (676 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (631 commits)")[![ImgBotApp](https://avatars.githubusercontent.com/u/31427850?v=4)](https://github.com/ImgBotApp "ImgBotApp (7 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (6 commits)")[![allcontributors[bot]](https://avatars.githubusercontent.com/in/23186?v=4)](https://github.com/allcontributors[bot] "allcontributors[bot] (2 commits)")[![luokuncool](https://avatars.githubusercontent.com/u/6022635?v=4)](https://github.com/luokuncool "luokuncool (2 commits)")[![midfar](https://avatars.githubusercontent.com/u/965943?v=4)](https://github.com/midfar "midfar (1 commits)") --- Tags commandcommand-line-toolcommandlinedownloaddownloadermusicphpsearchsongsearchdownloadmusicsongdl ### Code Quality TestsPest Static AnalysisPHPStan, Rector Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/guanguans-music-php/health.svg) ``` [![Health](https://phpackages.com/badges/guanguans-music-php/health.svg)](https://phpackages.com/packages/guanguans-music-php) ``` ### Alternatives [elasticsearch/elasticsearch PHP Client for Elasticsearch 5.3k178.3M940](/packages/elasticsearch-elasticsearch)[ruflin/elastica Elasticsearch Client 2.3k50.4M202](/packages/ruflin-elastica)[solarium/solarium PHP Solr client 93532.7M97](/packages/solarium-solarium)[opensearch-project/opensearch-php PHP Client for OpenSearch 15024.3M64](/packages/opensearch-project-opensearch-php)[jsq/amazon-es-php Support for using IAM authentication with the official Elasticsearch PHP client 9310.6M13](/packages/jsq-amazon-es-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)