Troubleshooting Lyrics Sources

Start with the message shown by Codafy, then use the matching section below.

No valid source snapshot was found

If Codafy reports No valid lyrics source snapshot was found in the clipboard:

• Copy only the raw JSON object or Base64 string.
• Confirm that the JSON contains every expected property.
• Check capitalization in property names and enum values.
• Remove Markdown code fences, comments, and trailing commas.

Compare the clipboard content with the Lyrics source snapshot reference.

Source already exists

Codafy found an installed source with the same name, base URL, and endpoint. Use the existing source or open it from the Sources list to edit it.

The source test fails

Check the source in this order:

1. Open the sample request URL in a browser and confirm that it returns HTTP 200–299.
2. Confirm that the response is valid JSON.
3. Verify that every query parameter name matches the provider API exactly.
4. Use a test track known to exist on the provider.
5. Confirm that the provider does not require authentication, custom headers, or a POST request.
6. Check the device connection and provider availability.

The source saves but finds no lyrics

• Confirm whether the top-level response is an array or one object.
• Check match and lyrics field names against the provider’s JSON response.
• Confirm that title, artist, and duration resemble the metadata stored in Plex.
• Ensure duration is returned in seconds rather than milliseconds.
• Confirm that synchronized lyrics contain timestamps and use the configured field.
• Enable Fallback to Plain Lyrics if the provider returns only unsynchronized text.
• Move the source higher in the Sources list if it should be searched earlier.

Synced lyrics are not displayed

The configured synced-lyrics field should contain LRC-style timestamps, for example:

[00:12.50] First line of the song
[00:17.20] Second line of the song

If the provider stores plain text in that field, map it to Plain lyrics field instead and enable Fallback to Plain Lyrics.

Still need help

When contacting Codafy Support, include the provider name, the exact error message, and whether the sample request returns valid JSON. Do not send authentication tokens or private server credentials.