8000 GitHub - whoxamxl/AALyrics: Synchronized lyrics for Android Auto with multi-provider matching, intelligent provider selection, and support for your music player of choice. · GitHub
[go: up one dir, main page]

Skip to content
whoxamxlPublic

About

Synchronized lyrics for Android Auto with multi-provider matching, intelligent provider selection, and support for your music player of choice.

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

80 Commits

Folders and files

Repository files navigation

AALyrics

AALyrics

Synchronized lyrics for Android and Android Auto.

Works with Spotify, YouTube Music, Apple Music and other Android MediaSession players.

Android 8.0+ AALyrics 1.0 Beta PolyForm Noncommercial

Support AALyrics on Buy Me a Coffee Download AALyrics APK from GitHub Releases

Android Auto experience

AALyrics brings the active lyric context into Android Auto Now Playing and stays usable in split view alongside navigation.

AALyrics Android Auto Now Playing with synchronized lyrics

Now Playing with the active synchronized lyric, artwork, seek state, and available transport controls.

AALyrics Android Auto split view alongside navigation

AALyrics in Android Auto split view alongside navigation.

Phone experience

AALyrics synchronized lyrics screen AALyrics expanded player AALyrics playback queue

AALyrics observes the active Android media session, matches the current track against multiple lyrics providers, and presents the best available lyrics in real time. The core experience is already functional on Phone and Android Auto, with on-device Translation, experimental word-synced Karaoke, playback controls, and signed in-app updates built around it.

Highlights

  • Synchronized lyrics — plain, line-synced, and genuine word-synced lyrics when the selected provider supplies them.
  • Android Auto Now Playing — current lyric line, artwork, translated line when eligible, and the transport controls exposed by the active media app.
  • Multiple lyrics providers — LRCLIB, PetitLyrics, Musixmatch, and SyncLRC with provider-independent candidate selection.
  • On-device Translation — translated lyrics remain tied to the canonical lyric document and playback timing.
  • Experimental WORD_SYNC Karaoke — opt-in Phone presentation for genuine word-timed lyrics.
  • Phone playback surface — play/pause, previous/next, seek, relative seek, and Queue support where the active media app exposes them.
  • Built-in updates — signed GitHub Release APK discovery, SHA-256 verification, package/signing preflight, and Android PackageInstaller handoff.

Get AALyrics

AALyrics requires Android 8.0 (API 26) or later and is distributed outside Google Play as a signed APK through GitHub Releases.

Open GitHub Releases →

  1. Download the current signed AALyrics-vX.Y.Z[-channel.N].apk.
  2. Install the APK. Android may ask you to allow the browser or file manager to install unknown apps.
  3. Open AALyrics.
  4. Enable Notification access for AALyrics. This is required so AALyrics can identify and follow the active Android media session.

Each Release also includes a matching .sha256 file for APK integrity verification.

After the first release-signed installation, later AALyrics releases signed with the same key can update the installed app normally. AALyrics can also discover, verify, and hand off newer releases through its in-app update flow.

Note

Current Debug and Release builds use separate application IDs and can coexist. If you installed a Debug build from before this split, uninstall that legacy Debug build before installing the first signed Release APK because it used the Release application ID with a different signing identity.

Android Auto

AALyrics currently uses the sideloaded Android Auto media compatibility path and focuses on a clean Now Playing lyrics experience.

To enable it:

  1. Install and open AALyrics on the phone and enable Notification access.
  2. Enable Android Auto developer mode.
  3. Open Android Auto Developer settings and enable Unknown sources.
  4. Reconnect Android Auto if needed.
  5. Make sure AALyrics is enabled in the Android Auto launcher/customize list.

The host receives the active track, artwork, supported playback actions, current synchronized lyric line, and an eligible translated line when available. Android Auto controls the final layout and text truncation.

AALyrics 1.0 Beta

AALyrics has moved beyond the construction-only stage. Its primary purpose — following lyrics for the track currently playing — is functional on Phone and Android Auto.

The 1.0 Beta line means the intended product identity and core experience are established, while some advanced functionality is still evolving:

  • Sync calibration controls and persistence are still in development.
  • Phone WORD_SYNC Karaoke remains experimental and opt-in.
  • Android Auto is currently line-oriented Now Playing rather than full Phone feature parity or Karaoke presentation.

These are Beta limitations, not a claim that the app is feature-complete or ready for a stable 1.0.0 release.

Lyrics, Translation & Karaoke

AALyrics can consume plain, line-synchronized, and genuine word-synchronized lyrics depending on what the selected provider returns.

Phone lyrics automatically follow playback while still allowing manual browsing. Shared timing semantics keep Phone and Android Auto aligned to the same canonical lyric document. Genuine word-synchronized data can additionally drive the experimental Phone Karaoke presentation.

Translation uses the established AALyrics Translation pipeline and on-device language models where supported. Translated text is secondary presentation only: it remains tied to the identity and timing of the canonical lyrics.

Actual lyric availability and timing quality depend on the metadata exposed by the active media app and on matching lyric data available from the providers.

Support AALyrics

If AALyrics is useful to you and you want to support continued development, you can contribute through Buy Me a Coffee.

Support AALyrics on Buy Me a Coffee

Development

AALyrics is an Android project built with Gradle. For a local debug installation:

./gradlew :app:installDebug

CI uses JDK 17. Local/CI debug APKs are development artifacts and are not interchangeable with the signed GitHub Release channel.

Project structure & developer documentation
app                    Android application / composition root
core:model             Shared domain models
core:lyrics            Lyrics lifecycle and orchestration
core:timing            Shared synchronized-lyrics timing semantics
provider:api           Provider contracts
provider:matching      Provider-neutral matching semantics
provider:lrc           Shared LRC parsing
provider:selection     Cross-provider candidate selection
provider:lrclib        LRCLIB integration
provider:petitlyrics   PetitLyrics integration
provider:musixmatch    Musixmatch integration
provider:synclrc       SyncLRC integration
platform:media         Android media-session / playback integration
ui:designsystem        Shared UI tokens and components
ui:phone               Phone presentation
ui:automotive          Android Auto presentation

Start with:

Package: io.github.whoxamxl.aalyrics

License

AALyrics is source-available, not Open Source Initiative (OSI) open source.

The project is licensed under the PolyForm Noncommercial License 1.0.0. Personal and other noncommercial uses are permitted under its terms. Commercial use requires separate permission from the copyright holder.

See LICENSE for the complete terms.

About

Synchronized lyrics for Android Auto with multi-provider matching, intelligent provider selection, and support for your music player of choice.

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages

0