Empieza con spicetify --version. Si PowerShell muestra una versión, la CLI está disponible en PATH; si no reconoce el comando, repara la instalación o PATH antes de ejecutar apply o restore.
Usa spicetify config para revisar ajustes, spicetify apply para cambios normales, spicetify backup apply después de instalar o cuando Spotify sustituye recursos, y spicetify restore para recuperar los archivos limpios guardados. Cierra Spotify antes de modificar sus archivos.
Tabla de comandos Spicetify según la tarea
Elige el comando por el resultado que necesitas. Una orden corta no sustituye revisar la salida, la versión activa, el paquete de Spotify y la ruta de recuperación documentada.
| Tarea | Comando PowerShell | Qué hace | Precaución |
|---|---|---|---|
| Comprobar la CLI | spicetify --version | Muestra la versión activa | Confirma qué ejecutable encuentra PowerShell |
| Revisar configuración | spicetify config | Muestra ajustes y rutas | Revisa antes de cambiar rutas |
| Aplicar ajustes | spicetify apply | Aplica tema, extensiones, apps y opciones | Cierra Spotify primero |
| Crear copia base y aplicar | spicetify backup apply | Guarda recursos compatibles y aplica | Úsalo tras instalar o sustituir recursos |
| Restaurar recursos | spicetify restore | Recupera la base limpia guardada | No desinstala la CLI |
| Actualizar la CLI | spicetify update | Actualiza instalaciones compatibles | Respeta el método de instalación |
| Abrir ayuda | spicetify --help | Lista comandos y opciones actuales | Mejor que una lista antigua |
Los comandos de la CLI suelen ser iguales en PowerShell, CMD y Terminal. Cambian la instalación, las rutas, los permisos y los gestores de paquetes.
Abrir PowerShell de forma segura y comprobar Spicetify
Abre una ventana normal de PowerShell con tu usuario. El modo administrador no es el valor recomendado: puede crear diferencias de permisos entre Spotify, Spicetify y la sesión de escritorio.
Ejecuta spicetify --version antes de una recuperación. Si el nombre no se reconoce, no descargues un ejecutable ajeno ni pegues cambios aleatorios de variables. Vuelve a abrir la consola, comprueba PATH y sigue la guía de instalación de tu plataforma.
Usa Get-Command spicetify si sospechas que hay instalaciones duplicadas. PowerShell mostrará la ruta que resuelve; un binario antiguo anterior en PATH puede seguir ejecutándose después de una actualización.
- 1
Comprobar la versión
Confirma que PowerShell encuentra la CLI y guarda la versión completa.
spicetify --version - 2
Localizar el ejecutable
Comprueba la ruta si puede haber una instalación duplicada o antigua.
Get-Command spicetify - 3
Leer la ayuda integrada
Consulta los comandos y opciones admitidos por la versión instalada.
spicetify --help
Revisar y cambiar la configuración de Spicetify
Ejecuta spicetify config sin argumentos para ver los ajustes actuales. La configuración controla rutas de Spotify, tema, esquema de color, extensiones, aplicaciones personalizadas y opciones de comportamiento.
La forma general es spicetify config clave valor. Por ejemplo, un flujo de temas puede definir current_theme y color_scheme antes de spicetify apply. Cambia un valor cada vez. Guardar una preferencia no modifica necesariamente Spotify hasta ejecutar apply.
Ten especial cuidado con prefs_path y spotify_path. Deben apuntar a las preferencias y recursos del cliente de escritorio compatible. No uses el reproductor web, una caché cualquiera ni una carpeta de paquete no verificada.
spicetify config
Aplicar, guardar y restaurar cambios
Usa spicetify apply para cambios normales en una instalación que funciona. Usa spicetify backup apply cuando falta una base limpia o Spotify ha sustituido recursos. Usa spicetify restore para volver a los recursos guardados.
Cierra Spotify antes de apply, backup o restore. Guarda la primera línea de error y evita repetir la misma orden sin analizarla; así podrás distinguir compatibilidad, rutas, permisos, extensiones o recursos obsoletos.
Restore no equivale a desinstalar. Puede restaurar Spotify y dejar instalada la CLI, la configuración, los temas y las extensiones. Sigue la guía de desinstalación para eliminarlo todo.
| Situación | Comando | Paso siguiente |
|---|---|---|
| Cambió un tema o extensión | spicetify apply | Abre Spotify y verifica un cambio |
| Primera instalación o sin copia válida | spicetify backup apply | Espera a que termine |
| Necesitas una comparación limpia | spicetify restore | Prueba Spotify sin personalización |
| Spotify se actualizó | spicetify backup apply | Comprueba antes la compatibilidad de la CLI |
Elegir el comando correcto para actualizar Spicetify
El método depende de cómo instalaste la CLI. spicetify update sirve para instalaciones compatibles con el instalador; las instalaciones de un gestor de paquetes deben actualizarse normalmente con ese mismo gestor.
Después de actualizar, ejecuta spicetify --version y compáralo con GitHub oficial. La versión verificada para esta guía es v2.44.0, publicada el 4 de julio de 2026 UTC. Una versión futura puede cambiar este dato.
Actualizar Spicetify no es actualizar Spotify. Spotify puede sustituir recursos y exigir una nueva copia y aplicación aunque la CLI no haya cambiado. Revisa la compatibilidad antes de forzar versiones o usar instaladores antiguos de terceros.
spicetify update
Resolver errores de PowerShell, PATH, administrador y procesos
Trata el primer error claro como una pista. Un comando no reconocido apunta a instalación o PATH; un aviso de administrador indica elevación insegura; los errores de acceso suelen implicar procesos abiertos o permisos.
| Síntoma | Causa probable | Acción segura |
|---|---|---|
| spicetify no se reconoce | Falta en PATH o la consola no se actualizó | Reabre PowerShell, usa Get-Command y repara la instalación oficial |
| No debe ejecutarse como administrador | PowerShell elevado | Ciérralo y usa una consola normal |
| Permiso denegado | Spotify abierto o permisos distintos | Cierra procesos y evita elevaciones repetidas |
| No encuentra Spotify | Paquete o rutas incorrectos | Abre el cliente de escritorio y revisa spicetify config |
| Desapareció la personalización | Spotify sustituyó recursos | Verifica compatibilidad y sigue backup/apply |
Las opciones que evitan controles de administrador o compatibilidad no son la solución normal para una ventana negra, PATH ausente o archivos bloqueados.
Preguntas sobre comandos PowerShell de Spicetify
¿Cuál es el primer comando PowerShell de Spicetify?
Ejecuta spicetify --version para confirmar que PowerShell encuentra la CLI y ver la versión activa.
¿Debo ejecutar Spicetify como administrador?
Normalmente no. Usa una ventana normal salvo que una instrucción oficial actual exija elevación en un paso concreto.
¿Qué diferencia hay entre apply y backup apply?
Apply usa la base existente; backup apply crea o renueva la base compatible y después aplica la configuración.
¿Qué comando restaura Spotify?
spicetify restore recupera los recursos limpios guardados, pero no elimina toda la CLI ni su configuración.
¿Cómo veo todos los comandos?
Ejecuta spicetify --help y consulta la referencia oficial de la CLI para tu versión.
¿Por qué no se reconoce el comando spicetify?
Puede faltar la CLI, necesitarse una nueva ventana de PowerShell o existir un problema de PATH. Usa Get-Command spicetify y la guía oficial.
Fuentes oficiales utilizadas
- Referencia de comandos CLI de Spicetify — Documentación oficial de comandos y opciones.
- Primeros pasos con Spicetify — Flujo oficial de instalación, actualización, copia y aplicación.
- Spicetify v2.44.0 — Última versión verificada, publicada el 4 de julio de 2026 UTC.