Troubleshooting

Should you encounter a problem, it may be listed here:

Container not starting

Check your yaml against what is in the example here. It could be as simple as a formatting issue with spaces or tabs. (tabs not allowed in yaml)

Container crashing after start

Check the container logs and see what they say. Ensure that there are no firewalls enabled that are blocking docker bridge networks, or access to Plex, Sonarr, and Radarr.

Red bar at the top of the screen

This indicates that your browser window is too small to display the poster without it being cut off. Please increase the size of the window, or try it on a higher resolution screen.

Slides are showing blank

• Check the Slide Duration and the number on-demand values. If you have a lot of on-demand titles selected, they can take a little while to download. Try waiting a few seconds after you have changed settings, or refresh the screen. (This is more prevalent with themes, art, slower Plex servers, and larger on-demand numbers) You can also try to reduce the number of on-demand slides, along with increasing the slide duration.
• If supplying your own mp3 files, reduce these to around 1000kb, or less, per file.
• If the browser is running remotely, be mindful of the internet connection speed. You may need to reduce the number of slides, art, or turn off themes for remote users.

Container started but cannot access the app in a browser

This could be that the default port 3000 is in use already. Try setting it to another port, like 9876.

The poster image looks to be the wrong size

Posters for Now screening and on-demand, come from your Plex library. Find the media item in your library and update the poster art.

Missing Sonarr, Radarr, or on-demand slides

It is possible that Plex, Sonarr, or Radarr may have been unavailable for some reason when Posterr tried to poll them for data. Because data loads for on-demand and coming soon are infrequent, the data may be missing. Whilst this will sort itself out within a day, you can go to settings and click 'save' to force a system restart.

No themes being played

• Provided that you have enabled the TV theme option, then this is normal. Most, but not all, TV shows have themes available.
• If you are never getting tv themes, then ensure that you are using the 'plex tv series' agent for your tv library.
• If you are supplying your own mp3 files for the /randomthemes folder, then consider the size of these files. Aim for under 1000kb, by limiting to only 30 seconds and a lower bitrate encoding.

Not getting music when a movie title is displayed (or music repetitive)

Providing you have enabled the Movie themes option, then there are two choices for music to play with movies. (In either case, if you don't have enough themes, then there will be duplication)

• Movie themes will play if added to your library folders as theme.mp3
• Provide your own MP3 files. (Set the randomthemes volume mount and add your own MP3's) These will play if no theme.mp3 present.

Adding additional MP3 files to your randomthemes folder will decrease potential repitition of music