How to Add or Customize Secondary Agents (e.g., for Lyrics) in the New Plex Music Agent?

Dev Community Dev/API Corner
1

Hello Plex Community,

I’ve noticed significant changes in how Plex handles music library agents recently. With the older music agents (like Last.fm or Freebase), we could easily configure Secondary Agents for albums or artists within the agent settings, for instance, selecting LyricFind to fetch lyrics.

However, with the new Plex Music Agent, I can’t find any options to set up secondary agents. I understand that the new Plex Music Agent now integrates LyricFind by default for lyrics.

My primary reason for asking this is: LyricFind often struggles to accurately retrieve or completely fails to find lyrics for Asian music (e.g., Chinese, Japanese, Korean songs).

My questions are:

  1. Is there still a way to add other custom secondary agents to the new Plex Music Agent? For example, if I wish to use a third-party lyrics provider that is more proficient with Asian music, is it possible to configure this as it was before?
  2. If direct addition isn’t possible, are there any recommended methods or workarounds to automatically or semi-automatically fetch lyrics from custom sources and integrate them into a Plex music library while using the new Plex Music Agent, specifically to address the inaccurate Asian music lyric retrieval?

Thank you all for your help and guidance!

1 Like
2
  1. unfortunately not at the moment. There will be a revamped support for custom agents in the future though.
  2. Find a way to put the lyrics in .txt or .lrc format right next to the audio file. It has to be named exactly like the audio file, save the file name extension. Then Refresh Metadata of the album and Plex should find the sidecar lyrics and integrate them.
    This is even preferable to using the integrated LyricFind method, as it doesn’t rely on an external source, and you can backup the lyrics together with your audio files.
4

Thanks for the prompt reply and the great news about future custom agent support! That’s definitely something to look forward to.

Following your guidance, I’ve decided to put aside attempts to extend the Plex Agent for lyric integration for now.

Instead, I’ll use an external program to monitor my music file directories. When it detects updates to music files, this program will automatically trigger song identification and initiate the lyric download process. The downloaded lyric files will then be placed alongside the music files, allowing Plex to load these local lyrics.

Thanks again for your help!

5

I’m curious what program you plan to use for this? I’d like to do the same.

6

Given that monitoring directory changes and accurately identifying newly added artists and albums can be quite complex, I’m currently leaning towards leveraging the PMS itself.

Specifically, my plan is to utilize webhooks. Once PMS completes its music library scan and identifies a new album, the library.new event will trigger an external program. This program will then perform the following steps:

  1. Obtain detailed song information (including file paths) for the new album via the PMS API.
  2. Using this information, retrieve and download the corresponding lyrics, saving the lyric files to the correct audio file directories.
  3. Finally, refresh the metadata for that specific album, allowing Plex to load and associate the local lyric files with the songs.

This approach lets me leverage PMS’s built-in scanning and identification capabilities, simplifying the external program’s logic while achieving automated lyric management.

1 Like
7

You can refer to my implementation：GitHub - firstep/LyricMix.bundle: A Plex Music Lyrics Extension

2 Likes
8

:orange_heart::orange_heart: :orange_heart: :orange_heart: :orange_heart: