Lyra

App de música personal para Android y Windows, estilo Spotify en negro, gris y blanco. Busca, reproduce y descarga música de YouTube Music y SoundCloud, se actualiza sola desde las releases de este repositorio y sincroniza tu biblioteca entre el móvil y el PC.

Web: https://lyra.shopxcenter.duckdns.org (descarga con el aviso de cómo instalarla)

Proyecto personal y sin ánimo de lucro. Usar YouTube de esta forma va contra sus condiciones de uso: es para uso propio.

⚠️ Antes de instalar Lyra (léelo si es la primera vez)

Lyra no está en Google Play, así que el móvil puede decir que es una app «dañina» o «no segura». No lo es: es una app de música sin anuncios y todo su código está en este repositorio. El aviso sale porque Google no la conoce y porque puede actualizarse sola, algo que también hacen apps peligrosas.

1. Descarga el archivo Lyra-v…_amigos.apk (aquí, en la última versión, abajo del todo en Assets): es la versión para instalar desde aquí. La otra, Lyra-v….apk, lleva la isla junto a la cámara y Google la bloquea más. Si el navegador dice «Este tipo de archivo puede dañar tu dispositivo», pulsa Descargar de todos modos.
2. Ábrelo. Si pide permiso para instalar apps desconocidas: Ajustes → activa Permitir de esta fuente → vuelve atrás.
3. Si sale «App bloqueada por Play Protect» o «App dañina»: pulsa Más detalles → Instalar de todos modos.
   • Si no aparece esa opción: abre Google Play → tu foto (arriba a la derecha) → Play Protect → ⚙️ → desactiva Analizar apps con Play Protect. Instala Lyra y vuelve a activarlo. Si más adelante avisa de Lyra, elige Ignorar o Mantener app.
4. En Xiaomi, Vivo, Oppo, Realme o Huawei puede salir además el aviso de seguridad del propio móvil: pulsa Instalar igualmente o Continuar (a veces hay que esperar unos segundos o poner la contraseña de la cuenta).
5. Las siguientes versiones se instalan desde la propia app (Ajustes → Buscar actualizaciones): no hace falta repetir esto.

⬇️ Descargar la última versión

En el ordenador (Windows 10 y 11)

1. Descarga Lyra-v…-Windows.msi (abajo, en Assets). Si el navegador dice que «no se descarga habitualmente», pulsa ⋯ → Conservar (en Chrome, Descargar de todos modos).
2. Ábrelo. Si sale «Windows protegió su PC», pulsa Más información → Ejecutar de todas formas. Sale porque Lyra no lleva una firma de pago, no porque haga nada malo.
3. Se instala sola en unos segundos, sin pedir permisos de administrador, y queda en el menú Inicio y en el escritorio. Las versiones nuevas se ponen solas.
4. Tu biblioteca en el móvil y en el PC: en el móvil, Ajustes → Biblioteca sincronizada → Activar; en el PC, Ajustes → escribe el código que te da.

Lyra para Windows

La misma música en el ordenador, en una ventana como la de Spotify: barra lateral con tu biblioteca, Inicio, Buscar, álbumes, artistas y playlists, cola y letra sincronizada a la derecha, y el reproductor abajo.

• Biblioteca sincronizada con el móvil: Me gusta, playlists, carpetas, álbumes y artistas (se emparejan con un código de 6 letras; va por el servidor de la web).
• Teclas multimedia del teclado y la tarjeta de Windows al cambiar el volumen (con la carátula), mini reproductor siempre encima y bandeja del sistema.
• Descargas en Música\Lyra («Artista - Canción.m4a» con carátula), fundido entre canciones como en Spotify, volumen igualado y ecualizador de 10 bandas.
• Se instala sin permisos de administrador y se actualiza sola (Lyra-v…-Windows.msi de cada release).

Funciones

• Inicio: accesos rápidos, tus mixes (radio infinita a partir de lo que más escuchas), "Porque escuchaste…", artistas parecidos y las secciones de YouTube Music (con chips de estado de ánimo).
• Buscar: sugerencias al escribir, pestañas (Todo, Canciones, Vídeos, Álbumes, Artistas, Playlists, SoundCloud), explorar por géneros y estados de ánimo, y pegar enlaces de YouTube o SoundCloud.
• Álbumes, artistas y playlists con descarga completa en un toque. Las playlists de YouTube o SoundCloud se pueden guardar como copia propia y volver a sincronizar.
• Descargas ocultas dentro de la app (Opus/M4A sin recomprimir, con carátula), que suenan sin conexión.
• Reproducción: crossfade (0-12 s), volumen igualado, ecualizador de 10 bandas con presets, saltar silencios, radio infinita al acabar la cola y cola reordenable.
• Letras sincronizadas de LRCLIB, a pantalla completa y tocables para saltar a esa parte.
• Fuera de la app: pantalla de bloqueo y notificación (con "Me gusta"), Android Auto, y una isla flotante junto a la cámara que se despliega con los controles.
• Copia de seguridad en un .zip (biblioteca, playlists, historial y ajustes; opcionalmente con las descargas).
• Actualizaciones: al abrir la app mira la última release de GitHub, enseña las novedades y se instala con un botón.

Ajustes recomendados tras instalar (Vivo)

1. Descarga el APK de la última release e instálalo.
2. Permite las notificaciones (controles en la pantalla de bloqueo).
3. En el aviso del Inicio pulsa Arreglarlo para quitar la optimización de batería. En los Vivo, además: Ajustes → Batería → Consumo en segundo plano → Lyra → Permitir.
4. La primera actualización pedirá permitir "Instalar apps desconocidas" a Lyra (solo una vez).
5. Isla (Ajustes → Isla flotante): actívala y da permiso de Accesibilidad → Lyra isla para que vaya junto a la cámara. Si sale en gris: info de la app → ⋮ → Permitir ajustes restringidos. Sin accesibilidad funciona con "Mostrar sobre otras apps", justo debajo de la barra de estado.
6. Android Auto: al ser una app instalada a mano, activa en Android Auto Ajustes para desarrolladores → Fuentes desconocidas.

Compilar

Android Studio (JDK 21, SDK 37) o desde consola:

.\gradlew.bat :app:assembleDebug      # APK de pruebas (com.lyra.music.debug, convive con la release)
.\gradlew.bat :app:testDebugUnitTest  # tests (parser, audio, letras, versiones)
$env:LYRA_LIVE_TESTS="1"; .\gradlew.bat :app:testDebugUnitTest   # también contra YouTube y SoundCloud reales

Lyra para Windows (desktop/, Compose Desktop) y lo común a las dos (core/):

.\gradlew.bat :desktop:run                 # abrirla desde el código (datos de prueba en %APPDATA%\Lyra-dev)
.\gradlew.bat :core:test :desktop:test     # pruebas (sincronización, audio…)
.\gradlew.bat :desktop:packageReleaseMsi   # el instalador .msi

Publicar una versión

.\release.ps1 -Version 1.0.1 -Notes "- Lo que cambia"

Sube la versión, pasa los tests, compila y firma el APK, hace commit y tag y crea la release en GitHub. El móvil la detecta al abrir Lyra.

Firma: las releases se firman con signing/lyra-release.jks usando los datos de keystore.properties. Ninguno de los dos está en el repositorio. Haz copia de seguridad de los dos: si se pierden, las actualizaciones no se podrán instalar encima y habrá que desinstalar (perdiendo las descargas).

Estructura

app/src/main/java/com/lyra/music/
├── data/
│   ├── source/innertube/   Cliente de YouTube Music (búsqueda, álbumes, artistas, radio, inicio)
│   ├── source/soundcloud/  NewPipeExtractor: URLs de audio de YouTube y todo SoundCloud
│   ├── source/lyrics/      LRCLIB
│   ├── db/                 Room: biblioteca, playlists, historial, descargas, letras
│   ├── download/           Cola de descargas (WorkManager, por trozos)
│   ├── repo/               Repositorios (música, biblioteca, inicio, letras)
│   └── backup/             Copias de seguridad
├── playback/               Servicio Media3, procesador de audio (EQ + volumen), crossfade, radio, Android Auto
├── island/                 Isla flotante
├── update/                 Actualizaciones desde GitHub
└── ui/                     Interfaz en Jetpack Compose

Licencia

GPL-3.0, porque usa NewPipeExtractor (GPL-3.0). Las letras vienen de LRCLIB y no se incluyen en el código.

Tipografías incluidas: Instrument Serif y Outfit, ambas con licencia SIL Open Font License 1.1 (textos en licenses/).