Home

𝗤𝗢𝗕𝗨𝗭-𝗗𝗟 𝗨𝗟𝗧𝗥𝗔

Downloader de linha de comando para o Qobuz focado em áudio lossless e Hi-Res, com metadados de qualidade de arquivista: ReplayGain, campos clássicos, ISRC, UPC, MBIDs do MusicBrainz, letras sincronizadas com tradução bilíngue e encartes digitais.

Requer Python 3.10+ e uma conta Qobuz com assinatura ativa.

pip install qobuz-dl-ultra
qobuz-dl -r                      # configuração inicial
qobuz-dl dl <url-do-album>       # baixar

O pacote instala dois comandos equivalentes: qobuz-dl e o atalho qdl.

Por onde começar

Se você quer…	Vá para
Instalar e configurar	Instalação → Configuração
Entender os comandos	Comandos
Controlar nomes de pastas e arquivos	Qualidade e Formatação
Ajustar tags e metadados	Metadados e Tags
Letras sincronizadas e tradução	Letras e Tradução
Cuidar de uma biblioteca grande	Manutenção da Biblioteca
Deixar a saída limpa (ou usar em cron)	Saída no Terminal → Automação
Entender o código	Arquitetura
Resolver um problema	Solução de Problemas
Copiar e colar algo que funcione	Receitas
Contribuir ou rodar os testes	Desenvolvimento

O que diferencia este projeto

Banco de dados com consciência de qualidade. O histórico de downloads tem chave primária (id, quality), então um upgrade de FLAC para Hi-Res não apaga o registro anterior. E se você perder o banco, o —sync-db o reconstrói lendo os IDs gravados nas tags dos seus arquivos.

Duplicatas detectadas por som. O —find-duplicates usa impressão digital acústica (Chromaprint/AcoustID), identificando a mesma gravação mesmo entre um FLAC e um MP3 com nomes e tags completamente diferentes. Em celular/iPad, cai automaticamente para comparação por metadados.

Letras em cascata, com .lrc bilíngue. Letras nativas do Qobuz (com marcação de tempo), tradução do Qobuz, LRCLIB e Genius como fallback. Quando há original e tradução, o programa casa as linhas pelos timestamps e gera um .lrc bilíngue sincronizado.

Interface de terminal adaptativa. Ajusta-se de 32 a 100 colunas, respeita NO_COLOR e FORCE_COLOR, e degrada os glifos Unicode em terminais legados.

Roda no iPhone e iPad. Suporte explícito ao a-Shell, com detecção automática do ambiente.

Dependências externas

Duas funcionalidades dependem de binários do sistema. Ambas são verificadas uma vez na inicialização, com aviso acionável quando faltam:

Binário	Necessário para
ffmpeg	--verify-download e operações de remux
fpcalc (Chromaprint)	--find-duplicates no modo acústico

Esta wiki documenta a versão 2.4.8.2. Conteúdo extraído do código-fonte, não de documentação legada.