Receitas

Receitas

Comandos prontos para copiar. Ajuste os caminhos e URLs.

Arquivo Hi-Res estrito

Coleção só com o que existe de verdade em alta resolução, organizada por artista e ano, com verificação de integridade:

qobuz-dl dl <url-do-artista> \
  -q 27 --no-fallback \
  --albums-only --smart-discography \
  -ff "{album_artist}/{year} - {album_title} [{bit_depth}B-{sampling_rate}kHz]" \
  -tf "{track_number} - {track_title}" \
  --musicbrainz --verify-download -e

O --no-fallback garante que nada rebaixado entre. O --smart-discography filtra tributos e karaokê. O --musicbrainz embute MBIDs para integração com Picard/Beets/Navidrome.

---

Ver antes de comprometer

qobuz-dl dl <url-do-artista> --dry-run
qobuz-dl dl <url-do-artista> --dry-run --since 2020
qobuz-dl dl <url-do-artista> --dry-run --albums-only --smart-discography

Sempre faça isso antes de uma discografia grande. Custa segundos e evita descobrir depois que os filtros estavam errados.

---

Reprocessar tags sem baixar de novo

Depois de mudar suas preferências de tag, aplique à biblioteca inteira sem gastar banda:

qobuz-dl dl minha-lista.txt --tag-only --multi-tags --musicbrainz

---

Trilhas sonoras de anime em lote

lista-de-animes.txt, um nome por linha:

while read -r nome; do
  qobuz-dl --quiet lucky "$nome OST" -n 2 -q 27
done < lista-de-animes.txt

Para conferir antes:

while read -r nome; do
  echo "=== $nome ==="
  qobuz-dl --quiet lucky "$nome OST" -n 2 --dry-run
done < lista-de-animes.txt

---

Perfis separados por biblioteca

# arquivo Hi-Res
CONFIG_DIR=~/perfis/hires qobuz-dl -r

# biblioteca MP3 para o celular
CONFIG_DIR=~/perfis/mobile qobuz-dl -r

Usando:

CONFIG_DIR=~/perfis/hires  qobuz-dl dl <url>
CONFIG_DIR=~/perfis/mobile qobuz-dl dl <url> -q 5

Cada perfil tem config.ini e banco próprios — o histórico é independente, então o mesmo álbum pode ser baixado em qualidades diferentes para destinos diferentes sem interferência.

Aliases no .bashrc:

alias qdl-hires='CONFIG_DIR=~/perfis/hires qobuz-dl'
alias qdl-mobile='CONFIG_DIR=~/perfis/mobile qobuz-dl'

---

Manutenção mensal

qobuz-dl --sync-db "/media/hd/musica"
qobuz-dl --find-duplicates "/media/hd/musica"
qobuz-dl lyrics "/media/hd/musica"
qobuz-dl stats

Reconcilia o banco com o disco, acha redundâncias, preenche letras faltantes e mostra onde a coleção está.

---

Encartes de uma discografia, sem o áudio

qobuz-dl dl <url-do-artista> --booklet-only

Só os PDFs de encarte digital e os arquivos extras.

---

Migrar do Spotify

# por URL
qobuz-dl ip https://open.spotify.com/playlist/xxxxx --name "Favoritas"

# por arquivo do Exportify (revisando os casos duvidosos)
qobuz-dl ip exportify.csv --name "Favoritas"

# aceitando automaticamente ≥60% de similaridade
qobuz-dl ip exportify.csv --name "Favoritas" --auto

Na primeira importação de uma playlist grande, rode sem --auto — vale o tempo de confirmar manualmente.

---

Só os lançamentos recentes de um artista

qobuz-dl dl <url-do-artista> --since 2024 -q 27

---

Baixar de uma gravadora inteira, filtrando

qobuz-dl dl <url-da-gravadora> \
  --albums-only --since 2015 \
  -b palavras-proibidas.txt \
  --dry-run

Tire o --dry-run quando a previsão estiver correta. O arquivo de blacklist tem uma palavra-chave por linha — veja blacklist_example.txt no repositório.

---

Playlist espelhada automaticamente

Primeira vez, manualmente, revisando o que ele quer apagar:

qobuz-dl sp https://play.qobuz.com/playlist/12345

Depois de confiar, no cron:

30 3 * * * qobuz-dl --quiet sp https://play.qobuz.com/playlist/12345 --yes

O --yes autoriza a exclusão de arquivos locais que saíram da playlist. Veja Automação.

---

Capas grandes na pasta, leves no arquivo

qobuz-dl dl <url> --og-cover --saved-art-size org --embedded-art-size 600 -e

Evita inflar cada FLAC com uma capa de vários megabytes, mantendo a versão em resolução total ao lado.

---

Retro-marcação contínua de letras

qobuz-dl --watch "/media/hd/musica"

Como serviço systemd permanente, veja Automação.

---

Múltiplos discos numa pasta só

qobuz-dl dl <url> \
  --multiple-disc-one-dir \
  -tf "{disc_number}-{track_number} - {track_title}"

Incluir {disc_number} no formato de faixa é obrigatório aqui — sem isso, as faixas de discos diferentes colidem de nome.

---

Stream JSON para um frontend

qobuz-dl --quiet dl <url> --progress-json

Uma linha JSON por evento no stdout. Lembre que não existe evento de falha — veja Automação para o exemplo de consumo em Python.

---

Conferindo o que está configurado

qobuz-dl -sc                    # configuração atual
qobuz-dl stats                  # estado da biblioteca
COLUMNS=60 qobuz-dl stats       # testar a interface estreita
qobuz-dl <comando> --help       # todas as opções de um comando