Skip to content

Spufify v1.1.0

Latest

Choose a tag to compare

@AlexAlvarezAlmendros AlexAlvarezAlmendros released this 16 Dec 15:28
· 1 commit to main since this release

🎉 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 .env automá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:

  1. Ve a https://developer.spotify.com/dashboard
  2. Inicia sesión con tu cuenta de Spotify
  3. Click en "Create app"
  4. 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
  5. Acepta términos y guarda
  6. Copia tu Client ID y Client Secret (los necesitarás en el paso 3)

2️⃣ Descargar e Instalar

  1. Descarga Spufify-Setup-1.1.0.exe desde esta página
  2. Verifica integridad (opcional pero recomendado):
    certutil -hashfile Spufify-Setup-1.1.0.exe SHA256
    # Compara con SHA256SUMS.txt
  3. Ejecuta el instalador (puede pedir permisos de administrador)
  4. 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.)
  5. Click "Install"
  6. ✅ La app se abrirá automáticamente al finalizar

3️⃣ Autenticar con Spotify

Al abrir Spufify por primera vez:

  1. Verás en el header: "⚠️ Not authenticated" (naranja)
  2. Click en ⚙️ Settings (abajo a la derecha)
  3. Busca la sección "Spotify Authentication"
  4. Click en "Authenticate with Spotify"
  5. Tu navegador se abrirá con una página de Spotify
  6. Inicia sesión si es necesario
  7. Click en "Aceptar" para dar permisos
  8. Vuelve a Spufify
  9. ✅ 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

  1. Abre Spotify Desktop y reproduce una canción
  2. Spufify detectará automáticamente la canción actual
  3. La grabación empieza automáticamente
  4. Al terminar la canción, se guarda en: C:\Users\TuUsuario\Music\Spufify\
  5. 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

Comunidad

Gracias a todos los que han probado versiones beta, reportado bugs, y sugerido mejoras.


📞 Soporte

Obtener Ayuda

  1. Revisa la documentación - README.md y documentos incluidos
  2. Busca en Issues - Puede que alguien ya haya resuelto tu problema
  3. 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


⭐ Si Spufify te es útil, considera darle una estrella en GitHub ⭐