SpotiCLI

Una aplicación de línea de comandos para controlar Spotify desde tu terminal.

Características

• 🔍 Buscar música
• 📋 Buscar playlists
• ⏯️ Reproducir/Pausar
• ⏭️ Siguiente canción
• ⏮️ Canción anterior
• 🎨 Visualización de artwork en ASCII art
• 🎵 Control completo de Spotify desde la terminal

Requisitos

• Node.js (versión 14 o superior)
• Cuenta de Spotify Premium
• Credenciales de la API de Spotify

Instalación

Instalación global desde npm (Recomendado)

npm install -g spoticli

Instalación desde código fuente

1. Clona este repositorio:

git clone https://github.com/tu-usuario/spoticli.git
cd spoticli

2. Instala las dependencias:

npm install

3. Instala globalmente:

npm install -g .

Configuración

1. Crea tus credenciales de Spotify:

   • Ve a Spotify Developer Dashboard
   • Inicia sesión con tu cuenta de Spotify
   • Crea una nueva aplicación
   • Copia el Client ID y Client Secret
   • Agrega http://localhost:8888/callback como URI de redirección

2. Al ejecutar spoticli por primera vez, se te pedirán las credenciales automáticamente.

Uso

Una vez instalado globalmente, simplemente ejecuta:

spoticli

Comandos disponibles

• Buscar música: Permite buscar y reproducir canciones
• Buscar playlists: Permite buscar y reproducir playlists
• Reproducir/Pausar: Controla la reproducción actual
• Siguiente canción: Avanza a la siguiente canción
• Canción anterior: Retrocede a la canción anterior
• Salir: Cierra la aplicación

Desarrollo

Para desarrollo local:

git clone https://github.com/tu-usuario/spoticli.git
cd spoticli
npm install
npm run dev

Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

Licencia

MIT - ver el archivo LICENSE para más detalles.

Soporte

Si encuentras algún problema, por favor abre un issue.