# Plex-overlay

Plex-overlay is a self-hosted media applications app. A self-contained Docker container that listens to Plex webhooks and shows a Now Playing poster. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2457/plex-overlay

## Description

A self-contained Docker container that listens to Plex webhooks and shows a Now Playing poster. Ideal for dashboards like DAKboard.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

29/100 (Low), based on 4 of 4 factors.
- Maintained: 34 (last commit 389 days ago)
- Popular: 17 (6 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/mbirnbach/plex-overlay
- Unraid: https://ca.unraid.net/apps/plex-overlay-0ed7zim0z9tyia?q=plex-overlay

## Common questions

### How do I connect plex-overlay to Plex Media Server?

Set the PLEX_HOST environment variable to your Plex server address including the port, and provide PLEX_TOKEN for thumbnail fetching. Then add the container's webhook endpoint in Plex's webhook settings.

### Which ports should I publish for the container?

It exposes two ports: the webhook listener, default 8080, and the static image server, default 8081. You can change both with WEBHOOK_PORT and STATIC_PORT.

### What should I point a dashboard image widget to?

Point it to the now-playing.png file served by the static image port. This gives the current movie or TV-show poster updated by Plex events.

### Does plex-overlay need a second container or shared folders?

No, it is an all-in-one container that provides both the webhook endpoint and the static file server. The documentation says it needs no shared folders or second container.

### How do I make the poster fit a portrait or landscape display?

Set CANVAS_WIDTH and CANVAS_HEIGHT to the desired output canvas size. The poster is resized, centered, and padded with black so it is not cropped.

## Alternatives

- Airwave: Airwave is a self-hostable service that turns your Plex library into custom, always-on live TV channels with a channel guide, recording, an…
- Ampache: Ampache is a self-hosted, web-based media server that streams and manages your music and video libraries from any device.
- Channels: Channels DVR is a self-hosted digital video recorder and streaming server that records live TV channels and lets you watch them alongside y…
- Emby: Emby is a self-hosted media server that organizes personal video, music, photo, and live TV libraries and streams them to smart TVs, stream…
- Infuse: Ignite your video content with Infuse – the beautiful way to watch almost any video format on your iPhone, iPad, and Apple TV.
- Jellyfin: Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media.
- Kodi: Kodi is a free, open-source media center and player that organizes and plays movies, shows, music, and photos on TVs, computers, and mobile…
- MediaChips: MediaChips is a desktop app for organizing local media libraries.
- Music Assistant: Music Assistant is a self-hosted, open-source music library manager for Home Assistant.
- OSMC: OSMC (Open Source Media Center) is a free and open source media player based on Linux and founded in 2014 that lets you play back media fro…
- Plex: Plex is a LinuxServer.io Docker container that runs Plex Media Server so home users can organize and stream personal video, music, and phot…
- Rygel: Rygel is a home media server for Linux that shares your audio, video, and pictures across your local network.

---
Source: Our Local Host (https://ourlocalhost.com/app/2457/plex-overlay), the self-hosted and open-source app directory.
