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.

A lot of work has gone into monitoring connection status between the browser and the Posterr app. In most cases, the browser app should resolve any connectivity issues without the need to be refresh.

• 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.

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 image / artwork.
• Whilst rare, I have seen this for Sonarr too. Unfortunately, we have no control over the Sonarr images.

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, and 'Plex Movies' agent for movie libraries.

Not getting music when a movie title is displayed

Providing you have enabled the Movie themes option, then movie themes will play if added to your library folders as theme.mp3 (using the latest Plex TV Series and Movie agents, along with use local assets being enabled in the library settings)

Getting trivia errors in logs

The trivia system uses a session token to get questions from the Open Trivia DB API. The session token is used to ensure that unique questions are returned as often as possible. If all the unique questions are exhausted, or the session token has expired (after 6 hours on inactivity), then an error code is returned. Posterr will then try to access the OTDB again with a new session token after one minute. The follow error and message sequence is fine, and can be ignored if everything recovers.

24/08/2021, 12:47:40 am *Trivia questions: Error: Open Trivia DB - All unique results returned. New token required
✘✘ WARNING ✘✘ - Next Trivia query will run in 1 minute.
✅ Got OTDB session token: 9b4b74afb11f251eb0c64b543933e39bd6ee09ca532bc095adabb525838ee5d0
24/08/2021, 12:48:42 am Trivia categories and questions added
✅ Trivia connection restored - defualt poll timers restored

You can minimise this happening by reducing the number of questions you return or the frequency that questions are refreshed.