guanguans/music-php

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

6.2.2 2025-09-17 06:09 UTC

Requires

• php: >=8.4
• guzzlehttp/guzzle: ^7.10
• laravel-zero/framework: ^12.0
• laravel-zero/phar-updater: ^1.4
• laravel/framework: ^12.29
• laravel/prompts: ^0.3
• metowolf/meting: ^1.5
• phpunit/php-timer: ^8.0
• spatie/fork: ^1.2

Requires (Dev)

• bamarni/composer-bin-plugin: ^1.8
• brainmaestro/composer-git-hooks: ^3.0
• buggregator/trap: ^1.13
• dealerdirect/phpcodesniffer-composer-installer: ^1.1
• dereuromark/composer-prefer-lowest: ^0.1
• dg/bypass-finals: ^1.9
• driftingly/rector-laravel: ^2.0
• editorconfig-checker/editorconfig-checker: ^10.7
• ergebnis/composer-normalize: ^2.48
• ergebnis/license: ^2.7
• ergebnis/php-cs-fixer-config: ^6.54
• ergebnis/rector-rules: ^1.6
• friendsofphp/php-cs-fixer: ^3.87
• guanguans/ai-commit: ^1.15
• guanguans/monorepo-builder-worker: ^2.0
• intonate/tinker-zero: ^1.2
• ion-bazan/composer-diff: ^1.13
• larastan/larastan: ^3.7
• laravel-lang/common: ^6.7
• laravel/facade-documenter: dev-main
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.8
• pb30/phpstan-composer-analysis: ^1.0
• pestphp/pest: ^4.1
• pestphp/pest-plugin-faker: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• pestphp/pest-plugin-type-coverage: ^4.0
• php-mock/php-mock-phpunit: ^2.13
• phpcompatibility/php-compatibility: ^9.3
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.1
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-mockery: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• phpstan/phpstan-webmozart-assert: ^2.0
• povils/phpmnd: ^3.6
• rector/jack: ^0.2
• rector/rector: ^2.1
• rector/swiss-knife: ^2.3
• rector/type-perfect: ^2.1
• shipmonk/composer-dependency-analyser: ^1.8
• shipmonk/dead-code-detector: ^0.11
• shipmonk/memory-scanner: ^1.0
• shipmonk/name-collision-detector: ^2.1
• shipmonk/phpstan-baseline-per-identifier: ^2.2
• spatie/pest-plugin-snapshots: ^2.2
• spaze/phpstan-disallowed-calls: ^4.6
• staabm/phpstan-todo-by: ^0.2
• symfony/thanks: ^1.4
• symplify/phpstan-extensions: ^12.0
• symplify/phpstan-rules: ^14.7
• tomasvotruba/class-leak: ^2.0
• tomasvotruba/cognitive-complexity: ^1.0
• tomasvotruba/type-coverage: ^2.0
• yamadashy/phpstan-friendly-formatter: ^1.2

Suggests

• ext-pcntl: Required for the fork driver

MIT

• guanguans

• search
• music
• download
• song
• dl

README

简体中文 | 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.

Requirement

• PHP >= 8.4

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/4.1.6

  USAGE:  <command> [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.

╰─ ./music-dl --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) [default: "sync"]
  -l, --locale[=LOCALE]                Specify the locale language [default: "zh_CN"]
  -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` or `--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

Testing

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

• guanguans
• All Contributors

License

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