FreeSong (Web & iPhone PWA)
Reproductor de música web optimizado para iPhone (iOS) y navegadores modernos, con interfaz fluida y funciones tipo Spotify Premium.
✨ Características
- Diseñado para iPhone: Instálalo como PWA tocando Compartir → Agregar a inicio en Safari. Funciona en pantalla completa con soporte de controles en pantalla de bloqueo (
MediaSession).
- Crossfade tipo Spotify Premium: Doble deck de audio con fundido cruzado regulable (0 a 12 segundos) y curvas de volumen en S sin silencios entre canciones.
- Música y Streaming: Búsqueda, reproducción completa de YouTube, Audius y tus propios archivos (MP3, M4A, FLAC).
- Letras sincronizadas: Integración con LRCLIB para cantar con la letra en tiempo real.
- Herramientas de audio: Ecualizador, velocidad (Slowed & Reverb / Nightcore), temporizador de apagado.
- Playlists propias: crea, renombra y elimina playlists; abre una para ver, quitar o reproducir sus canciones (guardadas solo en tu dispositivo).
- Atajos de teclado (escritorio):
Espacio reproducir/pausar, ←/→ retroceder/adelantar 5 s, Shift+←/Shift+→ canción anterior/siguiente.
- 100% Privado y Seguro: Sin anuncios, sin rastreadores, sin analíticas. Tus favoritos y playlists se guardan únicamente en tu dispositivo.
🚀 Despliegue en Vercel
Este repositorio está preconfigurado con vercel.json para despliegue automático en 1 clic en Vercel:
- Conecta este repositorio en Vercel.
- Pulsa Deploy (los archivos se sirven directamente desde
www).
- Abre el enlace en tu iPhone y disfrútalo.
🛠️ Desarrollo local
npm install
npm run build # compila Tailwind -> www/app.css
npm start # http://localhost:5173 (sirve www/ y emula las funciones de /api)
npm run icons # regenera los íconos PNG desde assets/icon.svg
🔊 Cómo funciona el streaming
api/stream.js obtiene la URL directa del audio desde YouTube con los clientes IOS y ANDROID, y la reenvía con soporte de Range para que Safari pueda saltar y precargar. En streaming sirve fragmentos de 512 KB; con full=1 entrega la pista completa (lo usan las descargas offline). Si todo falla responde 502.
⚠️ Limitación conocida
YouTube bloquea con frecuencia las IPs de los servidores de Vercel ("Sign in to confirm you're not a bot"), en todas las regiones. Por eso algunas canciones pueden no reproducirse desde el despliegue en la nube (en pruebas, 4 de 6). Cuando pasa, la app reintenta, avisa con un mensaje y salta a la siguiente (máximo 3 saltos seguidos). Desde una conexión residencial (por ejemplo npm start en tu PC) funciona de forma estable. La solución definitiva requiere resolver el audio desde el propio dispositivo o usar un proxy con IP residencial.
