Themerr-jellyfin connects Jellyfin to ThemerrDB, a community-maintained
database of theme songs. It downloads matching themes for movies and TV shows in your library, keeps Themerr-provided
themes up to date, and leaves user-provided theme.mp3 files untouched.
LizardByte has the full documentation hosted on Read the Docs.
The recommended installation method is to add the LizardByte plugin repository to Jellyfin. See the Jellyfin plugin documentation for additional information about installing plugins.
-
In Jellyfin, navigate to Dashboard → Plugins → Repositories.
-
Add a repository using this URL:
https://app.lizardbyte.dev/jellyfin-plugin-repo/manifest.json -
Open the plugin Catalog and search for
Themerr. -
Select and install the plugin.
-
Restart Jellyfin.
Other installation methods are also available:
- Portable: Download
themerr-jellyfin.zipfrom the latest release, extract it to your Jellyfin plugins directory, and restart Jellyfin. The portable archive supports Linux, macOS, and Windows. - Docker: The images on Docker Hub and GitHub Container Registry provide a LinuxServer.io Docker mod, not a standalone container. See the Docker documentation for configuration.
- Source: Installing from source is not recommended for most users. See the build documentation, then extract the generated zip archive to your Jellyfin plugins directory and restart Jellyfin.
- In your Jellyfin user settings, select Display, then enable Theme songs in the Library section.
- Ensure each movie and TV show is stored in its own directory. See Jellyfin's documentation for movies and TV shows for the required directory structure.
- Open the Themerr configuration page and select Update Theme Songs. Alternatively, open Jellyfin's Scheduled Tasks page and select Update Theme Songs under Themerr.
After the initial run, Themerr runs automatically according to the schedule configured on its configuration page.
Themerr messages are written to the Jellyfin server logs because Jellyfin does not maintain separate logs for plugins. See the Jellyfin log documentation to locate them. Review logs for sensitive information before sharing them because Themerr does not control other information logged by the Jellyfin server.
If you still need help, visit the LizardByte Support Center.
- Contribute themes through the ThemerrDB repository.
- Contribute translations through CrowdIn.
- For code contributions, see the build and testing documentation.