Visión general

Wave es un reproductor de música local-first: trae tus propios archivos de audio y Wave los organiza, los busca y los reproduce sin subirlos a ningún servidor. No hay cuenta, ni suscripción, ni backend, ni analítica.

El problema que resuelve

Los reproductores en streaming no sirven para la música que ya posees: archivos ripados de CD, descargas de Bandcamp, grabaciones propias o colecciones heredadas. Las alternativas locales suelen ser aplicaciones de escritorio pesadas, o bien proyectos que exigen crear una cuenta y subir tu biblioteca a la nube de un tercero.

Wave ocupa el punto intermedio:

• Funciona en el navegador, sin instalar nada en la mayoría de los casos.
• Los archivos no salen del dispositivo. Se guardan en el almacenamiento del propio navegador.
• No hay nada que configurar: se abre, se añade música y se reproduce.

Qué permite hacer

Las tres implementaciones

Wave no es una web envuelta tres veces. Son tres clientes independientes que comparten el modelo de datos y la intención de diseño:

• Web — React 19, TypeScript y Vite. Es el cliente más completo y el que marca el ritmo del resto.
• Windows — C# y WPF con Windows Media Player. Una aplicación nativa real, no un WebView.
• Android — Kotlin y Jetpack Compose, con API mínima 26. Es experimental y tiene menos funciones.

Las bibliotecas de cada plataforma son separadas: nunca se sincronizan ni se migran en silencio. Ver la comparación completa en Plataformas.

Stack técnico

Web       React 19 · TypeScript · Vite · IndexedDB (idb)
          music-metadata · motion · lucide-react · Nunito Sans
Windows   C# · WPF · .NET 10 · Windows Media Player
Android   Kotlin · Jetpack Compose · Gradle 8.13 · JDK 17 · API 26+
Pruebas   Vitest · Testing Library · Playwright · fake-indexeddb
Calidad   ESLint · Prettier · tsc -b estricto

Estado y límites conocidos

Lo que sí está implementado en el cliente web:

• Importación por selector de archivos y por arrastrar y soltar, con progreso, validación y detección de duplicados.
• Metadatos y carátulas incrustados, con inferencia conservadora desde el nombre de archivo cuando no hay etiquetas.
• Persistencia en IndexedDB de archivos y favoritos, con migración de biblioteca a versión 1.
• Edición local de metadatos con restauración del original.
• Suite de pruebas unitarias, de componentes y de navegador.

Lo que todavía no está:

• PWA instalable y arranque fiable sin conexión.
• Reordenación de la cola arrastrando.
• Copia de seguridad y restauración de la biblioteca.
• Importación de carpetas con permiso explícito.
• Firma de código en los instaladores nativos: los ZIP de Windows y los APK de Android son artefactos de prueba sin firmar.

Licencia y referencias

Wave se publica bajo licencia MIT. Las dependencias conservan sus propias licencias.

PixelPlayer es la referencia de organización de biblioteca local y de interacción del reproductor, pero Wave es una implementación independiente: no incluye código, carátulas ni marca de PixelPlayer. Tampoco está afiliado, patrocinado ni respaldado por PixelPlayer o Spotify AB.

Seguir leyendo en el repositorio

Esta guía resume y ordena. El repositorio trae además su propia documentación, bastante más extensa, y conviene saber qué hay y dónde está.

Recorrido de la guía

• Instalación — ponerlo en marcha en cinco minutos.
• Funciones y uso — el día a día del reproductor.
• Plataformas — qué hay en web, Windows y Android.
• Arquitectura — capas, flujo de datos y módulos.
• Privacidad y datos — qué se guarda, dónde y qué sale del dispositivo.
• Desarrollo — requisitos, comandos, pruebas de navegador y los diez fallos típicos.