music-dl

music-dl é uma ferramenta de linha de comando para busca e download de músicas, escrita em PHP, exigindo PHP >= 8.5. O projeto é destinado a fins de aprendizado e intercâmbio, e o README proíbe explicitamente seu uso para fins comerciais. Há duas formas de instalação: baixar diretamente o executável music-dl (obtido via curl e concedendo permissão de execução) ou instalar via Composer, globalmente ou localmente, o pacote guanguans/music-dl. O comando principal é music, usado para buscar e baixar músicas. É possível passar palavras-chave de busca como argumento, e há várias opções: -b/--break para interromper após o download; -d/--directory para especificar o diretório de download; -D/--driver para selecionar o driver de busca (sync, fork, process); -l/--locale para definir o idioma (padrão zh_CN); -N/--no-notify para desativar notificações de desktop; -p/--page e -P/--per-page para controlar a paginação (padrão página 1, 30 itens por página); -s/--sources para especificar fontes de música, suportando tencent, netease, kugou, com seleção múltipla; --isolated para evitar execução repetida do mesmo comando; --xdebug para exibir informações de depuração; --configuration para passar pares chave-valor de configuração dinamicamente. Além disso, há comandos auxiliares como completion (gerar scripts de completar shell), inspire, self-update (auto-atualização), thanks, e opções globais comuns como --help, --version, --ansi, --verbose. O projeto inclui scripts Composer para testes, php-cs-fixer, ecs, além de fluxo de trabalho CI e selo de cobertura de código, sob licença MIT.