LyricsForPoweramp

Usage Instructions

No changes are required in Poweramp settings to use this app.

This app is a lyrics plugin, not a standalone lyrics app. You cannot directly view lyrics in this plugin or select it as a Preferred Lyrics App in Poweramp settings.

Poweramp automatically sends a lyrics request when it doesn’t have lyrics available for a track.

• App settings

  • Theme

    You can manually change the app’s theme. Devices running Android 10+ can choose system default mode to follow system theme.

  • Lyrics Request.

    • Fallback to Search Method

      If the plugin cannot find the best match, it will fallback to a search method which may occasionally retrieve incorrect lyrics.

    • Notify on Lyrics Request Failure

      If the lyrics request fails, the app posts a notification. From this notification, you can launch the plugin prepopulated with track metadata to perform a manual search and update the lyrics.

    • Replace previous notification

      Enabling this option replaces the previous notification with a new one, preventing the notification panel from being flooded with failure notifications. However, this means you can perform manual search only for the most recent failed track.

    • Preferred Lyrics Type

      Choose whether the app should always try to send synced or plain lyrics to Poweramp. If the chosen type is not available for a track, the other type will be sent if available.

    • Mark Instrumental Songs

      There are non-vocal music tracks, also known as instrumental songs. If no lyrics are set for these tracks, Poweramp will prompt for lyrics every time you open the lyrics UI while playing them. This option will set dummy lyrics for instrumental tracks, preventing the lyrics request from appearing.

  • Lyrics Storage Settings

    • Send Lyrics to Poweramp

      [Recommended to keep enabled always]

      The result will be sent to Poweramp and cached in Poweramp’s internal memory. Advantages:

      • The lyrics will immediately appear in the Poweramp UI.
      • You can update lyrics directly from the Poweramp UI by launching the plugin using the ( :fast_forward: ) button. Disadvantages:
      • Poweramp won’t include these lyrics in its backup.
      • Poweramp gives lower priority to lyrics from the plugin and prefers lyrics from tags or files.

    • Save Lyrics as Files

      The lyrics will be stored in the same location as the music files.

      Advantages:

      • Lyrics will be preserved even if you perform a Full Rescan or Reinstall Poweramp
      • The lyrics may appear in other music players if they support displaying lyrics from files. Disadvangaes:
      • here may be a delay in loading lyrics into the Poweramp UI. Sometimes, Poweramp requires a rescan or restart.
      • You can’t easily change lyrics from the Poweramp UI.

      Tips for Selecting Folders:

      • When choosing a music folder, instead of selecting individual subfolders, try to select their parent folder.
      • You cannot select root directories due to Android restrictions.

      Updating Lyrics Files on Github Version:

      1. Delete the existing lyrics file from storage.
      2. Play the track again in Poweramp with:
         • Send to Poweramp enabled
         • Save Lyrics as Files disabled This will allow you to launch the plugin from Poweramp UI again.
      3. Before proceeding to search:
         • Enable Save Lyrics as Files
         • Disable Send to Poweramp (if you don’t need it)
      4. Go back to the plugin’s main screen and start a new search.
      5. From the search results, carefully select the lyrics you want.

      Updating Lyrics Files on PlayStore Version:

      The Play Store version includes a Library Screen, allowing you to change lyrics anytime without changing playback or launching Poweramp.

  • Filters

    You can specify filters for the title, artist, and album fields to remove matches from the corresponding search parameter. Filters can be strings or regular expressions.
    For example, to exclude strings like 320kbps from track title, enter \d{3}kbps in the title filter box. This will remove any such matches from the title.

• Search Modes

  The app offers two search options:

  • Coarse Search: Performs a keyword-based search that yields a broad range of results. This method sacrifices accuracy for quantity.

  • Fine Search: Focuses on specific fields such as track title, artist name, and album name. It provides more relevant results but limits the number of matches returned.

:information_source: Notes

• Lyrics sent to Poweramp by this plugin are cached by Poweramp and will be available offline.
• Poweramp makes a request only when the track doesn’t have any lyrics to display.
• When Poweramp initiates a lyrics request, you’ll see the message “Searching lyrics via plugin” in the Poweramp lyrics UI.
• For every lyrics request received, the plugin will try to get the best match available. If this fails and the fallback method is enabled, it performs a fine search operation and selects the suitable result, if available.
• To update lyrics set by this plugin in Poweramp, play the track in Poweramp and open the Lyrics UI. At the top, you’ll find an icon button( :fast_forward: ) next to the plugin name. Tap on it to launch the plugin and perform a search to retrieve available lyrics. Each lyrics result contains a choose icon ( :heavy_check_mark: ), upon clicking on it will send the lyrics to poweramp.
• To reset/delete all lyrics set by this plugin in Poweramp, perform a full rescan Poweramp Settings → Library → Full Rescan

Need any help? You can contact me here