Comece com spicetify --version. Se o PowerShell mostrar uma versão, a CLI está disponível no PATH; se não reconhecer o comando, corrija a instalação ou o PATH antes de apply e restore.
Use spicetify config para conferir ajustes, spicetify apply para mudanças comuns, spicetify backup apply após instalar ou quando o Spotify substitui recursos e spicetify restore para recuperar os recursos limpos salvos. Feche o Spotify antes de alterar arquivos.
Tabela de comandos do Spicetify por tarefa
Escolha o comando pelo resultado desejado. Uma ordem curta não substitui a leitura da saída, a versão ativa, o pacote do Spotify e o caminho de recuperação documentado.
| Tarefa | Comando PowerShell | O que faz | Cuidado |
|---|---|---|---|
| Verificar a CLI | spicetify --version | Mostra a versão ativa | Confirma o executável encontrado |
| Ver configuração | spicetify config | Mostra ajustes e caminhos | Leia antes de alterar caminhos |
| Aplicar ajustes | spicetify apply | Aplica tema, extensões e opções | Feche o Spotify |
| Criar backup e aplicar | spicetify backup apply | Salva recursos compatíveis e aplica | Após instalar ou substituir recursos |
| Restaurar | spicetify restore | Restaura a base limpa salva | Não desinstala a CLI |
| Atualizar | spicetify update | Atualiza instalações compatíveis | Respeite o método de instalação |
| Abrir ajuda | spicetify --help | Lista comandos e opções atuais | Melhor que listas antigas |
Os comandos da CLI costumam ser iguais no PowerShell, CMD e Terminal. Instalação, caminhos, permissões e gerenciadores de pacotes mudam.
Abrir o PowerShell com segurança e verificar o Spicetify
Abra uma janela normal do PowerShell com sua conta. O modo administrador não é o padrão e pode criar diferenças de permissão entre Spotify, Spicetify e a sessão da área de trabalho.
Execute spicetify --version antes de uma recuperação. Se o nome não for reconhecido, não baixe um EXE de terceiros nem altere o PATH no escuro. Reabra o console e siga o guia oficial da plataforma.
Use Get-Command spicetify quando houver possível instalação duplicada. O PowerShell mostra o caminho realmente usado; um binário antigo no início do PATH pode continuar ativo após a atualização.
- 1
Conferir a versão
Confirme que o PowerShell encontra a CLI e registre a versão completa.
spicetify --version - 2
Localizar o executável
Confira o caminho em instalações duplicadas ou antigas.
Get-Command spicetify - 3
Ler a ajuda integrada
Veja comandos e opções aceitos pela versão instalada.
spicetify --help
Conferir e alterar a configuração do Spicetify
Execute spicetify config sem argumentos para ver os ajustes. A configuração controla caminhos do Spotify, tema, esquema de cores, extensões, aplicativos personalizados e opções.
A forma geral é spicetify config chave valor. Um fluxo de tema pode definir current_theme e color_scheme antes de spicetify apply. Altere um valor por vez; salvar uma opção não modifica necessariamente o Spotify antes de apply.
Tenha cuidado com prefs_path e spotify_path. Eles devem apontar para preferências e recursos do cliente desktop compatível, não para o player web, cache aleatório ou pasta não verificada.
spicetify config
Aplicar, salvar e restaurar alterações
Use spicetify apply para mudanças comuns em uma instalação funcional. Use spicetify backup apply quando falta uma base limpa ou o Spotify substituiu recursos. Use spicetify restore para voltar aos recursos salvos.
Feche o Spotify antes de apply, backup ou restore. Salve a primeira linha clara de erro e não repita o mesmo comando sem análise; assim é possível separar compatibilidade, caminhos, permissões, extensões e recursos antigos.
Restore não é desinstalação. A CLI, configuração, temas e extensões podem permanecer. Siga o guia de desinstalação para remover tudo.
| Situação | Comando | Próximo passo |
|---|---|---|
| Tema ou extensão mudou | spicetify apply | Abra o Spotify e verifique |
| Primeira instalação ou backup inválido | spicetify backup apply | Aguarde concluir |
| Precisa testar estado limpo | spicetify restore | Teste sem personalização |
| Spotify foi atualizado | spicetify backup apply | Confira primeiro a compatibilidade |
Escolher o comando certo para atualizar o Spicetify
O método depende da instalação. spicetify update atende instalações compatíveis com o instalador; instalações de gerenciador de pacotes normalmente devem ser atualizadas pelo mesmo gerenciador.
Depois, execute spicetify --version e compare com o GitHub oficial. A versão verificada é v2.44.0, publicada em 4 de julho de 2026 UTC. Uma versão posterior pode mudar esta informação.
Atualizar o Spicetify não atualiza o Spotify. O Spotify pode substituir recursos e exigir novo backup/apply. Confira a compatibilidade antes de forçar versões ou usar instaladores antigos de terceiros.
spicetify update
Corrigir erros de PowerShell, PATH, administrador e processos
Use o primeiro erro claro como evidência. Comando não reconhecido aponta para instalação ou PATH; aviso de administrador indica elevação insegura; acesso negado costuma envolver processos abertos ou permissões.
| Sintoma | Causa provável | Ação segura |
|---|---|---|
| spicetify não é reconhecido | CLI ausente do PATH ou console antigo | Reabra o PowerShell, use Get-Command e repare a instalação oficial |
| Não executar como administrador | PowerShell elevado | Feche e use console normal |
| Acesso negado | Spotify aberto ou permissões diferentes | Feche processos e evite elevação |
| Spotify não encontrado | Pacote ou caminhos incorretos | Abra o cliente desktop e confira spicetify config |
| Personalização sumiu | Spotify substituiu recursos | Confira compatibilidade e siga backup/apply |
Opções que contornam administrador ou compatibilidade não são a correção normal para janela preta, PATH ausente ou arquivos bloqueados.
Perguntas sobre comandos PowerShell do Spicetify
Qual comando PowerShell do Spicetify executar primeiro?
Execute spicetify --version para confirmar que o PowerShell encontra a CLI e mostrar a versão ativa.
Devo executar o Spicetify como administrador?
Normalmente não. Use um console comum, salvo instrução oficial atual para uma etapa específica.
Qual a diferença entre apply e backup apply?
Apply usa a base existente; backup apply cria ou renova a base compatível e aplica a configuração.
Qual comando restaura o Spotify?
spicetify restore recupera os recursos limpos salvos, mas não remove toda a CLI nem a configuração.
Como ver todos os comandos?
Use spicetify --help e a referência oficial da CLI para a versão instalada.
Por que o comando spicetify não é reconhecido?
A CLI ou o PATH podem faltar ou o PowerShell precisa ser reaberto. Use Get-Command spicetify e a instalação oficial.
Fontes oficiais utilizadas
- Referência de comandos CLI do Spicetify — Documentação oficial de comandos e opções.
- Primeiros passos com Spicetify — Fluxo oficial de instalação, atualização, backup e aplicação.
- Spicetify v2.44.0 — Última versão verificada, publicada em 4 de julho de 2026 UTC.