Maintainerr Overlay Helperr
Maintainerr Overlay Helperr is an archived companion tool for Plex and Maintainerr users that periodically adds Netflix-style leaving-soon overlays to posters…
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.
30/100 Low
- Maintained
- 0GitHub repository is archived
- Popular
- 3136 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 85no serious findings, CI
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 40 days ago
- GitHub stars
- 36
- Open issues
- 5
- Last commit
- 2026-04-18
- Latest release
- v3.1.0
- License
- MIT
- Activity
- stale
Checked 10 days ago - source: GitHub (gssariev/maintainerr-overlay-helperr)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Start it with Docker and keep data Use the Docker run command from the docs, but make sure the -v ./data:/opt/data part points to a real folder on your PC. That folder is where Maintainerr keeps its settings and collection data, so if you don’t keep or back it up you can lose your data. source
- Open or remember port 6246 The -p 6246:6246 part tells your computer to let Maintainerr’s web page use port 6246. If that port is blocked by a firewall or another program, you won’t be able to open Maintainerr in your browser. source
- Set user ID and timezone Keep -u 1000:1000 unless you know the user/group IDs that own your data folder, because mismatched IDs can make the app unable to read or save its files. You can also change TZ=Europe/Brussels to your timezone so Maintainerr’s times match your local clock. source
- Plex and Maintainerr It requires working Plex and Maintainerr integrations to update posters. source
- Periodic updates It runs periodically, so keep the schedule aligned with Maintainerr cleanup so overlays stay current. source
- Repository status The GitHub repository is archived; verify the Docker image is current before installing. source
Fetched 7 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How do I connect Maintainerr Overlay Helperr to Plex and Maintainerr?
Set the PLEX_URL and PLEX_TOKEN environment variables for Plex and the MAINTAINERR_URL environment variable for Maintainerr. The script uses these to download posters and apply overlays.
Can it process more than one Plex collection at a time?
Yes. Set PROCESS_COLLECTIONS to the collections you want, and it can process multiple collections while reordering each based on deletion date.
How do I schedule when the overlays are refreshed?
Use the CRON_SCHEDULE environment variable to define the periodic run. You can also set RUN_ON_CREATION to run it on creation.
How do I remove overlays and restore original posters?
Use the overlay reset and deletion option to revert to the original poster and delete the generated overlay poster from the Plex metadata folder. The Docker environment includes RESET_OVERLAY for controlling this behavior.
Can it show a countdown instead of an exact leaving-soon date?
Yes. You can choose between the calculated removal date and days remaining, with related controls such as USE_DAYS, DATE_FORMAT, and custom day text.
Answers sourced from github.com
Community
- Reddit (reddit)
- Has anyone successfully installed maintainerr? : r/unRAID - Reddit (reddit)
Collected 53 days ago - public community threads