Repository navigation
Releases
Spufify v1.1.0
🎉 Spufify v1.1.0 - Primera Release Oficial
Fecha de lanzamiento: 16 de Diciembre de 2025
📝 Sobre Esta Release
¡Bienvenido a la primera release oficial de Spufify! 🎵
Spufify es un grabador de audio en tiempo real para Spotify en Windows. Captura las canciones que escuchas y las guarda como archivos de alta calidad con metadatos completos y carátulas automáticas.
Esta versión incluye un sistema de autenticación manual de Spotify integrado en la UI, instalador completo con wizard de configuración, y soporte para múltiples formatos de audio.
📦 Contenido de la Release
Instalador Windows
📦 Spufify-Setup-1.1.0.exe
Tamaño: ~[XX] MB
Incluye: App empaquetada + FFmpeg + Dependencias
Características del instalador:
- 🔧 Wizard de configuración de credenciales Spotify
- 🔧 Genera archivo
.envautomáticamente - 🔧 Agrega FFmpeg al PATH del sistema
- 🔧 Crea accesos directos (Escritorio + Menú Inicio)
- 🔧 Desinstalador con opción de mantener grabaciones
Archivos Incluidos
Spufify-Setup-1.1.0.exe - Instalador completo
💾 Instalación
Requisitos Previos
Sistema Operativo:
- Windows 10 (64-bit) o superior
- Windows 11 (recomendado)
Software:
- Spotify Desktop App (obligatorio)
- Cuenta de Spotify Developer (gratis - ver instrucciones abajo)
Pasos de Instalación
1️⃣ Crear Spotify Developer App (5 minutos)
Necesitas credenciales de la API de Spotify:
- Ve a https://developer.spotify.com/dashboard
- Inicia sesión con tu cuenta de Spotify
- Click en "Create app"
- Rellena:
- App name: Spufify (o el nombre que quieras)
- App description: Personal audio recorder
- Redirect URI:
http://127.0.0.1:8888/callback⚠️ EXACTO - APIs used: Web API
- Acepta términos y guarda
- Copia tu Client ID y Client Secret (los necesitarás en el paso 3)
2️⃣ Descargar e Instalar
- Descarga
Spufify-Setup-1.1.0.exedesde esta página - Verifica integridad (opcional pero recomendado):
certutil -hashfile Spufify-Setup-1.1.0.exe SHA256 # Compara con SHA256SUMS.txt
- Ejecuta el instalador (puede pedir permisos de administrador)
- Wizard de configuración:
- Acepta la licencia MIT
- Elige carpeta de instalación (default:
C:\Program Files\Spufify) ⚠️ IMPORTANTE: Ingresa tu Client ID y Client Secret de Spotify- Elige opciones (acceso directo en escritorio, etc.)
- Click "Install"
- ✅ La app se abrirá automáticamente al finalizar
3️⃣ Autenticar con Spotify
Al abrir Spufify por primera vez:
- Verás en el header: "
⚠️ Not authenticated" (naranja) - Click en ⚙️ Settings (abajo a la derecha)
- Busca la sección "Spotify Authentication"
- Click en "Authenticate with Spotify"
- Tu navegador se abrirá con una página de Spotify
- Inicia sesión si es necesario
- Click en "Aceptar" para dar permisos
- Vuelve a Spufify
- ✅ El indicador cambiará a "✅ Spotify OK" (verde)
¡Listo! Solo necesitas hacer esto una vez. La app recordará la autorización.
4️⃣ Grabar Tu Primera Canción
- Abre Spotify Desktop y reproduce una canción
- Spufify detectará automáticamente la canción actual
- La grabación empieza automáticamente
- Al terminar la canción, se guarda en:
C:\Users\TuUsuario\Music\Spufify\ - El archivo incluirá:
- ✅ Título y artista correctos
- ✅ Carátula del álbum
- ✅ Metadatos completos
🆕 Novedades en v1.1.0
Nueva Funcionalidad: Autenticación Manual
- Antes: La app abría el navegador automáticamente al iniciar (molesto)
- Ahora:
- La autenticación se hace desde Settings cuando el usuario quiera
- Indicador visual de estado en el header
- Verificación periódica cada 5 segundos
- Mensajes claros de estado (✅/
⚠️ /❌)
Mejoras en la UI
- Indicador de autenticación en header con feedback de color
- Sección dedicada "Spotify Authentication" en Settings
- Botón "Check Status" para verificar token manualmente
- Mensajes informativos sobre el proceso de auth
Sistema de Build
- Instalador profesional con Inno Setup
- Wizard de configuración de credenciales
- Generación automática de archivo
.env - FFmpeg bundleado en el instalador
- Agregado automático de FFmpeg al PATH
Documentación
- Guías completas de instalación y uso
- FAQ extendido con 15+ preguntas
- Scripts de testing automatizados
- Documentación técnica para desarrolladores
🐛 Problemas Conocidos
Limitaciones
⚠️ Solo Windows: Actualmente solo soporta Windows 10/11 (64-bit)⚠️ Grabación 1:1: Una canción de 3 minutos tarda 3 minutos en grabarse (es tiempo real)⚠️ Spotify Desktop obligatorio: No funciona con Spotify Web
Issues Conocidos
- En algunos sistemas con audio virtualizado (VMs), puede haber problemas de detección del dispositivo loopback
- Si Windows tiene múltiples dispositivos de audio, puede requerir selección manual en Settings
- El crossfade de Spotify puede causar que se mezclen canciones si no se desactiva
Soluciones: Ver documentación en README.md o abrir un Issue en GitHub.
📋 Configuración Recomendada
Windows Audio
Panel de Control → Sonido → Tu dispositivo → Propiedades → Avanzadas:
❌ Desmarca "Mejoras de audio"
❌ Desmarca "Permitir control exclusivo"
✅ Volumen al 100%
Spotify App
Spotify → Settings:
Calidad: Very High
❌ Desmarca "Crossfade"
❌ Desmarca "Automix"
❌ Desmarca "Gapless playback"
Spufify
Settings → Audio Format:
Output Format: FLAC (mejor calidad)
Sample Rate: 48000 Hz (auto)
Buffer Block Size: 2048 (default)
🙏 Agradecimientos
Librerías y Herramientas
- Spotipy - Wrapper Python para Spotify API
- SoundCard - Captura de audio multiplataforma
- FFmpeg - Conversión de audio
- CustomTkinter - UI moderna para Python
- Mutagen - Manejo de metadatos de audio
- PyInstaller - Empaquetado de Python
- Inno Setup - Creación de instaladores Windows
Comunidad
Gracias a todos los que han probado versiones beta, reportado bugs, y sugerido mejoras.
📞 Soporte
Obtener Ayuda
- Revisa la documentación - README.md y documentos incluidos
- Busca en Issues - Puede que alguien ya haya resuelto tu problema
- Abre un nuevo Issue - Si no encuentras solución
Reportar Bugs
Al reportar un bug, incluye:
- Versión de Spufify (1.1.0)
- Versión de Windows (10/11)
- Pasos para reproducir
- Logs o capturas de pantalla
- Mensaje de error completo
Contacto
- GitHub Issues: https://github.com/AlexAlvarezAlmendros/Spufify/issues