Skip to content

Posterr Configuration

Matt P edited this page Jul 25, 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 10-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)
Custom picture themes ON / OFF Enable to play themes and fx for custom picture (if present)
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.

UI Customisations

Option Description
Colours Select custom colours for Title, Tagline, and Background
Title fonts This Lets you select different fonts to use for the slide title.
Alternate Title Text Allows you to change the text of slide titles. Leave blank for default values.

If you set your password to nothing, then you will not see a login screen for settings. (Only do this for local installs)

Plex Options

Option Description
*HTTPS connection ON / OFF If your Plex server requires a secure connections (leave this off if using a reverse proxy, or if you do not a have an SSL certificate and domain for Plex)
*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)

Custom Pictures

Option Description
Enabled Enable or disable custom pictures
Theme Folder Select the default or other folders (if you have added these)

Details for custom pictures are HERE

Now Screening

Option Description
Pin now screening / now playing If something is playing, then these are the only slides that will display

On-Demand

Option Description
Plex Libraries for On-demand titles Enter the Plex library name(s) to use for on-demand slides. Comma-separated 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
Genres Lets you filter on-demand titles by genre. (due to a plex query limitation, only the first 2 genres applied to a title are searchable by Posterr

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