Como baixar músicas usando o Spotdl

01 Abr, 2025

Nota: usuários são inteiramente responsáveis por suas ações e potenciais consequências legais. Não apoio download não autorizado de material protegido por direitos autorais e não me responsabilizarei pelas ações dos usuários.

Ontem eu tava pelo Mastodon e vi um toot de Henrique Sebastião sobre uma ferramenta pra baixar músicas, mas ele mencionou a galera do self-host e eu não sou a galera do self-host. Fui tentar me meter nessa e acabei achando mais complicado do que poderia. Pensando sempre, então, nas demais almas que não são do flearows via blambers , quis trazer esse pequeno tutorial (inclusive pra mim mesmo, quando formatar o pc de novo).

Pra começar

Eu não entendo muito de docker e acho que talvez seja mais fácil ficarmos apenas com o Spotdl (quem sabe um dia eu expanda esse tutorial pra abarcar também o Downtify).

A primeira coisa que precisamos ter atenção é se já temos Python instalado, a partir da versão 3.7 em diante. Para isso, abra um terminal (ou o prompt de comando, se você estiver usando Windows) e digite:

Para Linux ou Mac
python3 -V

Para Windows
python -V

É bem comum nossos computadores já terem alguma versão de Python. Se não for o caso do seu, você pode baixar a versão mais recente aqui. Caso você note que a versão de Python que você tem instalada é mais antiga que 3.7, pode rodar os seguintes comandos para atualizar:

No Windows: python -m pip install –upgrade python
No Mac ou Linux: pip install –upgrade python

Ambiente virtual

O próximo passo é criar um ambiente virtual para evitar conflitos com outras aplicações. Para facilitar a sua vida, você pode navegar diretamente para a pasta onde você quer que o Spotdl fique e baixe as músicas. No meu caso, eu escolhi hospedá-lo na minha pasta de Músicas.

Se você não souber como fazer esse passo, entre na pasta desejada, clicando mesmo e, se estiver no Windows, use a barra de pesquisa do explorador de arquivos, digitando "cmd" e apertando Enter.¹ O prompt de comando deve abrir. Caso você esteja no Linux, clique com o botão direito em um espaço vazio e use a opção "Abrir no terminal". No Mac, essa opção deve aparecer como "New terminal at folder".²

Feito isso, podemos ir em frente e criar o nosso ambiente virtual. No terminal (ou prompt de comando), digite:

No Windows: python -m venv env
No Linux ou Mac: python3 -m venv env

Depois de rodar o comando acima, apertando Enter, você pode entrar no ambiente virtual utilizando o seguinte comando:

No Windows: env\Scripts\activate.bat
No Linux ou Mac: source env/bin/activate

Vale ressaltar que o terminal mostrará uma pequena diferença assim que você adentrar o ambiente virtual, com um "(env)" antes da linha de usuário.

Finalmente, Spotdl

Finalmente, podemos instalar o Spotdl. Cole e execute o comando abaixo, dentro do ambiente virtual:

pip install spotdl

Depois que o Spotdl for instalado, instale também o FFmpeg, ainda dentro do ambiente virtual:

spotdl --download-ffmpeg

Como usar?

O Spotdl possui uma interface web fácil de utilizar, mas a própria documentação diz que a interface web tem recursos limitados e só baixa uma música de cada vez. Não se preocupe, também é bem fácil usar pelo próprio terminal, e bem mais prático. Dentro do ambiente virtual, digite o comando:

spotdl download 'link da playlist'

O download deve começar e as músicas começarão a aparecer na pasta onde você criou o ambiente virtual.

Atualizando o Spotdl

Caso você comece a encontrar dificuldades nos downloads, cheque se a versão do seu spotdl não precisa ser atualizada! No terminal, dentro do ambiente virtual, digite o segunte comando:

pip install --upgrade spotdl

Caso reinicie o computador ou ligue outro dia e deseje baixar mais músicas, lembre de abrir o terminal na pasta de criação do ambiente virtual e adentrar o ambiente virtual antes de rodar os comandos do Spotdl!

Versão genérica