Plex-overlay
A self-contained Docker container that listens to Plex webhooks and shows a Now Playing poster.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
29/100 Low
- Maintained
- 34last commit 389 days ago
- Popular
- 176 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 304 GB minimum RAM
Availability: platform listings confirmed today, links checked 26 days ago
- GitHub stars
- 6
- Open issues
- 0
- Last commit
- 2025-10-27
- License
- GPL-3.0
- Activity
- stale
Checked 8 days ago - source: GitHub (mbirnbach/plex-overlay)
Resources & Compatibility
Minimum requirements: 4 GB RAM. ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Set owner IDs and keep /config saved Set PLEX_UID/PLEX_GID (the user and group IDs the container runs as) to match your host folders, and mount /config as a persistent folder on your computer. If the IDs are wrong or /config is lost, Plex may fail to start or your library and settings may disappear. source
- Link your account with a claim token Add PLEX_CLAIM (the one-time claim code from Plex.com) before the first start so the container can sign in automatically. Without it, you need to find and type the setup code manually, which can be annoying if you miss it. source
- Point Plex at your LAN correctly Set ADVERTISE_IP to your real local IP with the web port (32400) and ALLOWED_NETWORKS to your trusted home networks. Wrong values can make devices unable to find Plex or leave Plex exposed more than you intended. source
Fetched 54 days ago - each note links to its source
Variants
Alternatives (12)
- 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.
Checked 40 days ago - source: AlternativeTo
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.
Answers sourced from github.com
Community
- Plex overlays and collections for all : r/PleX - Reddit (reddit)
- Plex Forum (forum)
- Plex Forum (forum)
- How to 100% self host plex? - Plex Media Server - Plex Forum (forum)
Collected 47 days ago - public community threads