Installation Guide

There are a couple of ways to install SongSync on your Android device.

Recommended: IzzyOnDroid

For automatic updates and a trusted installation source, we recommend installing SongSync via the IzzyOnDroid F-Droid repository.

If you don't have it already, add the IzzyOnDroid repository to your F-Droid client.
Search for "SongSync" and install it.

You can also download the latest APK file directly from our GitHub Releases page.

Navigate to the SongSync Releases Page.
Find the latest release and download the app-release.apk file.
Open the downloaded file on your Android device to install it. You may need to enable "Install from unknown sources" in your device's settings.

Upon first launch, SongSync will guide you through an initial setup screen to grant necessary permissions. Here's what each permission is used for:

All Files Access (MANAGE_EXTERNAL_STORAGE): This is the core permission for SongSync. It is required to:
- Scan your device's storage for local music files (e.g., MP3, FLAC).
- Save the downloaded .lrc lyric files in the same directory as the corresponding music file, which is how most music players detect them.
- Embed lyrics directly into music file metadata.
Post Notifications (POST_NOTIFICATIONS): (Android 13+) This optional permission allows SongSync to show a persistent notification indicating the progress of batch lyric downloads. This is useful for long-running tasks.
Notification Listener (BIND_NOTIFICATION_LISTENER_SERVICE): This optional permission enables the "Now Playing" feature. It allows SongSync to read metadata from your media player's notification (like song title and artist) to quickly identify the current track. SongSync does not read the content of any other notifications.
Internet (INTERNET): Required to connect to the various online lyric providers to search for and download lyrics.