Elige tu plataforma. Dale play.
spotatui está disponible en las herramientas que los desarrolladores ya usan. Spotify es opcional: en el primer arranque te pregunta qué fuente quieres usar, y las fuentes gratuitas no necesitan cuenta.
brew tap LargeModGames/spotatui
brew install spotatuiElige una fuente o sáltate Spotify por completo
Spotify requiere Premium, inicia sesión con un código de vinculación
YouTube gratis, requiere yt-dlp
Subsonic gratis, requiere un servidor
Internet Radio gratis
Local Files gratis
Qobuz suscripción de pago, inicia sesión en el navegador
Apple Music app Música de macOS, requiere permiso de Automatización
Al elegir Spotify (ahora o más tarde con d), spotatui muestra un código corto y abre la página de vinculación de Spotify en tu navegador. Confirma el código ahí y el inicio de sesión queda guardado. No hace falta crear una app de desarrollador de Spotify ni un client ID. Spotify en spotatui requiere una cuenta Premium. Ejecuta spotatui --reconfigure-auth para volver a iniciar sesión, por ejemplo con otra cuenta.
Migra con un solo comando
El binario ahora se llama spotatui (antes spt) y la configuración vive en ~/.config/spotatui/. Copia tu configuración anterior:
mkdir -p ~/.config/spotatui
cp -R ~/.config/spotify-tui/. \
~/.config/spotatui/La primera vez tendrás que iniciar sesión en Spotify de nuevo; el client ID de spotify-tui ya no se usa.
Se actualiza solo.
Al iniciar spotatui, comprueba GitHub Releases. Si hay una versión nueva, verifica la descarga con su checksum, la instala y se reinicia. Los subcomandos como spotatui playback nunca se actualizan. Si lo instalaste con un gestor de paquetes, pon disable_auto_update: true bajo behavior: en config.yml para que el gestor siga a cargo. auto_update_delay espera antes de instalar, y spotatui --no-update omite la comprobación una vez.
¿Prefieres una ventana? Instala la app de escritorio.
El mismo reproductor en su propia ventana, con la distribución de la app de escritorio de Spotify: Tu biblioteca, páginas de inicio, álbum, artista y letras, la cola y un selector de dispositivos. Usa el mismo inicio de sesión, la misma configuración y el mismo historial que la app de terminal, y solo una de las dos corre a la vez. Al cerrar la ventana, la app guarda la sesión y se cierra. La vista previa reproduce solo Spotify, así que requiere Premium. Descárgala de la página del lanzamiento:
| Sistema | Archivo |
|---|---|
| Windows 10/11 (64 bits) | spotatui-desktop_<version>_x64-setup.exe |
| macOS, Apple Silicon | spotatui_<version>_aarch64.dmg |
| macOS, Intel | spotatui_<version>_x64.dmg |
| Debian/Ubuntu | spotatui-desktop_<version>_amd64.deb o _arm64.deb |
| Fedora | spotatui-desktop-<version>-1.x86_64.rpm o .aarch64.rpm |
| Otras distros Linux | spotatui-desktop_<version>_amd64.AppImage o _aarch64.AppImage |
Los instaladores aún no están firmados, así que tu sistema muestra un aviso la primera vez. En Windows, SmartScreen dice "Windows protegió tu PC": haz clic en Más información y luego en Ejecutar de todas formas. En macOS, cierra el diálogo, abre Configuración del Sistema > Privacidad y seguridad, haz clic en Abrir de todos modos junto al mensaje de spotatui y confirma. Si macOS dice que la app está dañada, ejecuta xattr -dr com.apple.quarantine /Applications/spotatui.app una vez.
En Linux requiere glibc 2.39 y WebKitGTK 4.1: Ubuntu 24.04 o posterior, Debian 13, Fedora 40 o posterior, o Arch. Si la ventana queda en blanco en Wayland con una GPU NVIDIA, iníciala con GDK_BACKEND=x11 spotatui-desktop.
Si la instalaste con el instalador de Windows, la app de macOS o el AppImage, se actualiza sola: al abrirse y cada 6 horas comprueba la última versión estable, verifica la firma de la actualización y la instala cuando sales, o al instante con el botón Update ready. Una instalación .deb o .rpm se actualiza con una nueva descarga. disable_auto_update y auto_update_delay la controlan, también desde la página Settings de la app. Para controlar la app de escritorio desde un agente de código por MCP, instala también el spotatui de terminal: solo él tiene spotatui mcp.
O descarga un binario precompilado.
Builds para macOS (Intel y Apple Silicon), Linux (x86_64 y ARM64) y Windows, además de paquetes .deb para Debian y Ubuntu (amd64 y arm64), con cada lanzamiento. Cada uno incluye su checksum .sha256.