Instale e abra primeiro o cliente do Spotify para computador, entre na conta por pelo menos 60 segundos e feche o Spotify. No Windows, execute o comando oficial do PowerShell mostrado acima. No macOS ou Linux, execute curl -fsSL https://raw.githubusercontent.com/spicetify/cli/main/install.sh | sh. Finalize com spicetify backup apply.
O que é necessário antes de instalar Spicetify
O Spicetify personaliza arquivos usados pelo cliente oficial do Spotify para computador. Ele não substitui o aplicativo Spotify, portanto instalar a CLI antes do Spotify não deixa nada para modificar. Baixe o Spotify de uma fonte legítima para computador, abra, entre na conta e mantenha uma instalação nova aberta por pelo menos 60 segundos. Isso cria as preferências locais e os dados de aplicativo verificados pelo Spicetify.
Feche o Spotify antes da primeira aplicação. Você também precisa de um terminal: PowerShell no Windows ou Terminal no macOS e Linux. Acesso de administrador normalmente não é o objetivo; use privilégios elevados somente quando a localização documentada do pacote realmente exigir mudança de permissões.
- Cliente do Spotify para computador compatível, não o reprodutor web
- Conexão à Internet que acesse conteúdo raw e versões do GitHub
- PowerShell no Windows ou shell normal no macOS/Linux
- Alguns minutos para criar um backup antes das mudanças
Execute o comando oficial para instalar Spicetify
O instalador oficial é o método recomendado porque seleciona a versão atual e configura a localização da CLI.
Abra o PowerShell como usuário normal do Windows, cole o comando abaixo e pressione Enter. O script está no repositório oficial spicetify/cli do GitHub. Você pode abrir o endereço raw no navegador e examinar o script antes de executar.
No macOS e Linux, use o comando shell indicado nos guias específicos. Winget, Scoop, Chocolatey, Homebrew e AUR são alternativas válidas, mas as atualizações futuras devem usar o mesmo gerenciador que realizou a instalação.
iwr -useb https://raw.githubusercontent.com/spicetify/cli/main/install.ps1 | iex
Crie o backup e aplique o Spicetify
Instalar a CLI não modifica o Spotify imediatamente. O primeiro comando de aplicação cria um backup dos recursos originais do cliente e depois aplica a configuração atual do Spicetify. Manter esse backup é importante porque fornece ao comando de restauração um estado limpo conhecido.
Se o Spotify ainda estiver aberto, feche antes de aplicar. Quando o comando terminar, inicie o Spotify normalmente. Uma primeira execução correta pode parecer semelhante ao Spotify original até você adicionar tema, extensão, aplicativo personalizado ou Marketplace.
- 1
Confirme a CLI
Abra um novo terminal e confirme que o comando está disponível.
spicetify --version - 2
Feche o Spotify
Saia totalmente do cliente para computador em vez de deixá-lo minimizado na bandeja.
- 3
Faça o backup e aplique
Crie o backup limpo e aplique a configuração atual.
spicetify backup apply - 4
Abra o Spotify
Inicie o Spotify novamente e confirme que ele abre normalmente antes de outras personalizações.
O backup torna previsíveis a restauração e a recuperação após atualizações. Se você já alterou arquivos manualmente, restaure o Spotify para um estado limpo antes de criá-lo.
Instale o Marketplace depois que a CLI funcionar
O Marketplace adiciona ao Spotify um catálogo de temas, extensões, aplicativos personalizados e trechos. Trate-o como uma segunda etapa, não como a própria CLI do Spicetify. Verifique spicetify --version e spicetify backup apply antes de adicionar o Marketplace. Essa separação facilita muito a solução de problemas.
Instalações guiadas atuais podem oferecer o Marketplace automaticamente. Se estiver ausente, use o instalador oficial do guia dedicado. Depois de uma atualização do Spotify, reaplique o Spicetify antes de presumir que todos os itens do Marketplace precisam ser baixados novamente.
Mantenha o Spicetify funcionando após atualizações
O Spotify substitui periodicamente seus arquivos de aplicativo. Quando um tema desaparece após uma atualização, a CLI geralmente continua instalada. Execute primeiro spicetify backup apply. Se a CLI instalada não aceitar a nova versão do Spotify, execute spicetify update ou atualize pelo gerenciador usado originalmente.
Nunca force uma compilação antiga sobre uma versão do Spotify não aceita pelas notas oficiais. Aguardar uma versão compatível é mais seguro que repetir instalações ou alterar arquivos manualmente.
Uma instalação saudável é simples de verificar: spicetify --version retorna uma única versão clara, o Spotify abre sem pedir reparo e spicetify backup apply termina sem erro de caminho ou permissão. Anote o método usado para manter a mesma fonte nas atualizações. Se trocar de um gerenciador para o script, remova corretamente o pacote antigo para o terminal não escolher um executável desatualizado.
Salve a documentação e a página de versões oficiais, em vez de guardar apenas um comando copiado de uma publicação. O endereço do script pode permanecer estável enquanto a versão baixada muda. Arquivos por plataforma, faixas de compatibilidade, declarações e limitações conhecidas ficam nas notas oficiais.
Instalar Spicetify sem criar configurações duplicadas
Instalar Spicetify com segurança depende principalmente de manter um caminho previsível. Escolha o script oficial ou apenas um gerenciador, conclua o primeiro login no Spotify e teste a CLI antes do Marketplace. Essa ordem separa download, PATH, caminho do Spotify, backup, aplicação e personalização opcional. Se um comando falhar, guarde toda a saída antes de executar outro instalador.
Depois de instalar o Spicetify, abra um novo terminal e confira spicetify --version. Feche o Spotify e execute spicetify backup apply. O comando de versão mostra que o shell encontra a CLI; o comando de aplicação mostra que ela localiza e modifica um cliente compatível. Um tema visível não é obrigatório nessa verificação, pois a configuração básica pode parecer com o Spotify normal.
Registre o método de instalação nas notas de manutenção. Usuários do script seguem o atualizador oficial; Homebrew, Winget, Scoop, Chocolatey, AUR e Nix devem ser atualizados pelo gerenciador responsável pelo executável. Isso impede que uma cópia antiga ganhe prioridade no PATH e torna a investigação repetível. Para reinstalar, restaure primeiro o Spotify e remova o pacote anterior com o gerenciador original.
Depois de instalar Spicetify, abra outro terminal e registre a versão ativa antes de personalizar o cliente.
Para instalar Spicetify com um resultado previsível, mantenha o mesmo gerenciador nas próximas atualizações.
Se precisar instalar Spicetify novamente, restaure o Spotify e remova a cópia anterior pelo método original.
- Confirme apenas um executável ativo do Spicetify em um novo terminal.
- Verifique se o Spotify abre normalmente depois do backup e da aplicação.
- Adicione o Marketplace somente após a instalação básica funcionar.
Perguntas frequentes sobre a instalação do Spicetify
Instalo o Spotify antes do Spicetify?
Sim. Instale o cliente do Spotify para computador, abra, entre na conta por pelo menos 60 segundos e feche antes da primeira aplicação do Spicetify.
O Spicetify é um aplicativo com instalador comum?
O Spicetify é principalmente uma ferramenta de linha de comando. Scripts e gerenciadores oficiais instalam a CLI; arquivos manuais para plataformas específicas estão no GitHub.
Qual comando devo executar depois da instalação?
Execute spicetify backup apply para criar um backup limpo e aplicar a configuração atual.
Instalar Spicetify também instala o Marketplace?
Algumas configurações guiadas oferecem o Marketplace, mas ele é um projeto separado. Instale somente após testar a CLI.
Fontes oficiais utilizadas
- Primeiros passos do Spicetify — Comandos oficiais, primeira execução, atualização e instruções do Marketplace.
- Versões da CLI do Spicetify — Versões oficiais, arquivos, compatibilidade e notas.