Skip to content

Latest commit

 

History

History
173 lines (145 loc) · 7.68 KB

README.md

File metadata and controls

173 lines (145 loc) · 7.68 KB

Posterr

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

Docker Pulls Docker Image Size (tag) Image Build Version GitHub last commit Platforms User Guide

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
  • Display custom web pages as slides (if web page compatible) - EXPERIMENTAL!
  • Rotate display -90° (for running on display devices, like Firesticks, which do not support portait rotation)
  • Post API (at '/api/sleep') to toggle sleep mode. (Pass in header 'psw: your Posterr password')

Prerequisites

Mandatory

  • Plex

Optional

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

Installation

Installation details are as follows:

Docker Compose (X86, ARM32, ARM64)

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.

Unraid

  • 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

Star History Chart

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.


License

MIT

Free Software, Hell Yeah!