Skip to content

Posterr Configuration

Matt P edited this page May 18, 2021 · 31 revisions

Following is a description of each setup option. Options with a '*' are mandatory.

Also see the Example Configurations for common use cases.

General Options

Option Description
*Password Settings page password
*Slide duration How long (in seconds) a slide will be shown for. (suggest 5-30 seconds)
Enable background artwork Shows media artwork in a faded background behind the poster
TV themes ON / OFF Enable to play TV theme tunes. (note: some TV themes are unavaible)
Movie themes ON / OFF Enable to play theme.mp3 file from your movie file (if present), or play random tunes (add your own mp3's)
Slide Transitions Slide / Fade The slide transition effect.
Shuffle slides On-demand (slides by libraries), coming soon (Sonarr), and coming soon (Radarr) slides will be shuffled when on. When off, they display in the aforementioned order. 'Now screening/Playing' always displays at the start of the cycle.

Important If you choose to self-host your own mp3 files in the /randomthemes directory, then you should limit these to 30 seconds in length and a lower bit rate. (I use FFMeg Batch Converter.) Failing to do this may result in images or themes not loading before the corresponding slide is reached.

Plex Options

Option Description
*HTTPS connection ON / OFF If your Plex server requires a secure connections (leave this off if using a reverse proxy)
*Server IP The IP or domain name for plex (exclude http/https)
*Server port The port Plex uses (default is 32400)
*Plex token Token required to access Plex. (Finding a Plex token)
Plex Libraries for On-demand titles Enter the Plex library name(s) to use for on-demand slides. Comma-seperated if multiple libraries. (Leave this blank if you do not want on-demand slides)
Number to display The number of random titles to display, per-library, for on-demand slides (avoid going over 200 'combined' slides for all libraries, or may cause excessive polling on Plex server.)
On-demand refresh period The refresh period in minutes before a new set of random titles are loaded

Sonarr Options (v3 only)

Option Description
Sonarr token The Sonarr API key required for accessing Sonarr. (Leave this blank if you do not want coming soon TV titles to show)
Sonarr url The full URL and Port for your Sonarr installation.
Days ahead The number of days to look ahead in the Sonarr calendar for titles. Set this low number, like 3-5, if Show Premieres is off. Alternatively, up to 60+ days is fine if on.
Show premieres ON / OFF Only season premieres will be shown

Radarr Options

Option Description
Radarr token The Radarr API key required for accessing Radarr. (Leave this blank if you do not want coming soon Movie titles to show)
Radarr url The full URL and Port for your Radarr installation.
Days ahead The number of days to look ahead in the Radarr calendar for titles.
Clone this wiki locally