Installing a Lyrics Source

Codafy can search compatible third-party services when lyrics are not available from your Plex server. A lyrics source describes how Codafy should search a provider and read lyrics from its JSON response.

This documentation uses LRCLIB as a recommended, reliable example. LRCLIB is not required: you can configure any provider that follows the compatible request and response structure described below.

Open Lyrics settings

1. Open Codafy.
2. Go to Settings.
3. Select Lyrics.
4. Turn on Enable Lyrics.

Sources are searched from top to bottom. Use Edit to change their priority when more than one source is installed.

The same screen also includes two optional behaviors:

• Fallback to Plain Lyrics displays unsynchronized text when synchronized lyrics are unavailable.
• Prefetch on Playback begins the search when playback starts instead of waiting for the lyrics panel to open.

Choose an installation method

Import from the clipboard

Use clipboard import when a trusted website or support guide provides a compatible source snapshot. It is the fastest option because Codafy validates and tests the configuration automatically.

Import a lyrics source from the clipboard →

Configure a source manually

Use manual configuration when you are integrating a provider yourself or need to inspect every request and response mapping.

Configure a lyrics source manually →

Provider requirements

A compatible provider must:

• Use a public HTTPS search endpoint.
• Accept track metadata as query parameters in a GET request.
• Return valid JSON as one top-level object or an array of objects.
• Provide at least a track-title field and one lyrics field.

You are responsible for following the provider’s terms of use and attribution requirements.