Posterr

Media display software for Plex, Sonarr, Radarr, and Readarr. (Just like the display screens in movie theatre foyers)

Docker Pulls Image Build Version GitHub last commit

Slides Awtrix

Check Here for the latest updates
Visit the wiki for more information on known issues.
Visit the Discord Group for discussions and limited support.
The default password is: raidisnotabackup

IMPORTANT NOTE ON UPGRADES

There are rare times that you will need to update settings. Check here for detailed notes on each updated.

Features

Displays movies, shows, music poster for what is currently playing.
Displays random (on-demand) titles from multiple Plex libraries.
Displays custom pictures, background art, and themes
Shows coming soon titles from Sonarr (or Season premieres).
Shows coming soon titles from Radarr.
Shows coming soon books from Readarr.
Optionally plays TV and Movies themes, if available
A playing progress bar (green for direct play and red for transcoding)
Various metadata displayed, such as run time, content rating, studio, etc.
Move the mouse cursor to the bottom footer of the page to hide it
Background artwork option for improved landscape view (when available)
Automatically scales for most display sizes and orientation.
'Sleep timer' disables the display during set hours.
Trivia Quiz (multiple selectable topics)
Support LED Matrix displays running Awtrix software

Prerequisites

Mandatory

Plex

Optional

Sonarr v3.0
Radarr v4.3
Readarr v0.1.3

Installation

Installation details are as follows:

<ins>Docker Compose (X86, ARM32, ARM64)</ins>

Create the following directories in your docker folder:

./docker/posterr/config
./docker/posterr/custom

version: '2.4'

services:
  posterr:
    image: petersem/posterr
    container_name: posterr
    environment:
      TZ: Australia/Brisbane
      BASEPATH: ""
    volumes:
      - ./docker/posterr/config:/usr/src/app/config
      - ./docker/posterr/custom:/usr/src/app/public/custom
    ports:
      - 9876:3000
    restart: unless-stopped

Details

Option	Details
TZ	Your local timezone. Go to wikipedia and use the `TZ Database Name` value.
/docker/posterr/config	This is required to save your Posterr settings
/docker/posterr/custom	This is required for custom pictures (and other custom media in the future)
Ports	Change first part to a different port if needed. e.g. 9876:3000
BASEPATH	"/path" Use this for reverse proxy setups which require a base path value. This line can be left out, or value left blank if you dont use alternate paths.

<ins>Unraid</ins>

Use the Posterr template in community apps. (Being replaced with new version)

Updates

From v1.10.1, there will be a notice at the top of the settings screen informing you if you are running an old version.
Use containrr/watchtower to auto-update Posterr in Docker environments
Update in the usual way for Unraid

Setup

Get to the settings page in a number of ways:

On initial load, you will be prompted.
Change the URL to 'http://hostIP:9876/settings' (where hostIP is the IP number of the machine that Posterr is installed on. Change the port number if you set a different value. 3000 is the default for the binary executables)
Clicking on the top banner title of any slide.
If on the 'no content' page, then click this text

The default password is: raidisnotabackup

Possible Uses

Mount a monitor on your wall and showcase your home media setup
Use it on a second monitor to keep an eye on what is running
Run it on a small screen mounted outside your theater room to show when a movie is in progress
Use a reverse proxy, or port-forward, to let your friends see what is playing, available, and coming soon

Technical Features

Built in Node JS, and packaged as a Docker image. (included image health check)
Direct binary files also provided for MacOS, Linux, and Windows.
Low resource usage. Memory: 20-35mb, Diskspace: ~75mb, CPU: < 1% (running on a Synology NAS with a Celeron processor)
Checks for updates in Now Screening / Playing every 10 seconds (Will not display updates until browser refreshed or all slides cycled through)
Browser-based, so can run the app on one machine and a browser on another.
Browser connectivity checks and auto-reconnect when the Posterr app restarts. (eg During container updates)
Supports screen resolution heights from 320 pixels to around 3500 pixels.
Supports reverse proxy setup for wildcard dns or alternate base path.
Built-in recovery features should the Poster app, or Plex, go offline.

Please see the Posterr Wiki for more information.

Star History

Troubleshooting

Should you encounter a problem, the solution may be listed HERE.

Support

There is no 'official' support for this product, however should you encounter issues, raise an issue on the github page.
Limited support in Discord

Support my efforts and continued development

Thanks,

Matt Petersen (April 2021)

Technical Details

Posterr uses the following:

Node & Node Express
The awesome Node-Plex-APi
Jquery
Bootstrap
Font-Awesome
Plex (via PlexAPI)
Sonarr (via API)
Radarr (via API)
Readarr (via API)
Posters and artwork from Plex, TVDB and TMDB.
Awtrix (via API)

Notice

Posterr is dependant on third party applications and services. Some features may fail temporarily or permenantly if the dependancies are unavailable, or become incompatible for any technical or legal reason. This software comes with no warranty or guarantee of any kind. Images and themes that you download through Posterr may be copyrighted, and are the property of the respective copyright holders.