Maintainerr-Overlay-Helperr

Overview

Works in combination with Maintainerr, adding a Netflix-style "leaving soon" overlay on top of your media. It integrates with Plex and Maintainerr to download posters, add overlay text, and upload the modified posters back to Plex. It runs periodically to ensure posters are updated with the correct information.

Requirements

Expects a font file named `font.tff` to be present in the Font Path.

Runtime arguments

Network: bridge
Privileged: false

Template configuration

Plex - URLVariable

URL to your Plex server

Target: PLEX_URL
Default: http://plex:32400
Value: http://plex:32400

Plex - TokenVariable

Plex token for authentication

Target: PLEX_TOKEN

Maintainerr - URLVariable

URL to your Maintainerr server

Target: MAINTAINERR_URL
Default: http://maintainerr:6246
Value: http://maintainerr:6246

Images PathPathrw

Path to save images

Target: /images
Default: /mnt/user/appdata/maintainerr_overlay_helperr/images
Value: /mnt/user/appdata/maintainerr_overlay_helperr/images

Fonts PathPathrw

Path to the font file

Target: /fonts
Default: /mnt/user/appdata/maintainerr_overlay_helperr/fonts
Value: /mnt/user/appdata/maintainerr_overlay_helperr/fonts

Plex Metadata PathPathrw

Path to Plex metadata (usually Library/Application Support/Plex Media Server/Metadata inside Plex root folder)

Target: /plexmeta

Image - Font ColorVariable

Color of the font in hex format

Target: FONT_COLOR
Default: #FFFFFF
Value: #FFFFFF

Image - Font SizeVariable

Size of the font

Target: FONT_SIZE
Default: 3.2
Value: 3.2

Image - Background ColorVariable

Background color of the image in hex format

Target: BACK_COLOR
Default: #B20710
Value: #B20710

Image - PaddingVariable

Padding around the image

Target: PADDING
Default: 1.2
Value: 1.2

Image - RadiusVariable

Radius of the image corners

Target: BACK_RADIUS
Default: 0
Value: 0

Image - Horizontal OffsetVariable

Horizontal offset of the image

Target: HORIZONTAL_OFFSET
Default: 0
Value: 0

Image - Vertical OffsetVariable

Vertical offset of the image

Target: VERTICAL_OFFSET
Default: 3
Value: 3

Image - Horizontal AlignmentVariable

Horizontal alignment of the image

Target: HORIZONTAL_ALIGN
Default: center|left|right

Image - Vertical AlignmentVariable

Vertical alignment of the image

Target: VERTICAL_ALIGN
Default: top|middle|bottom

Image - Reset OverlayVariable

Reset the overlay on the image

Target: RESET_OVERLAY
Default: false|true

Image - Reapply OverlayVariable

Reapply the overlay on the image

Target: REAPPLY_OVERLAY
Default: true|false

Image - Date FormatVariable

Date format for the image

Target: DATE_FORMAT
Default: MMM d|d MMM

Image - Use Date SuffixVariable

Enable or disable the use of date suffixes (e.g. January 1 vs January 1st)

Target: ENABLE_DAY_SUFFIX
Default: false|true

Image - Use Days LeftVariable

Enable to use days left; disable to use calculated date

Target: USE_DAYS
Default: true|false

Image - Date All CapitalizedVariable

Enable or disable all capitalized date

Target: ENABLE_UPPERCASE
Default: false|true

Image - Overlay TextVariable

Text to display next to the date

Target: OVERLAY_TEXT
Default: Leaving
Value: Leaving

Days Text - TodayVariable

Text to display for items leaving today when Use Days Left is enabled

Target: TEXT_TODAY
Default: Last chance to watch
Value: Last chance to watch

Days Text - One Day LeftVariable

Text to display for items leaving in 1 day when Use Days Left is enabled

Target: TEXT_DAY
Default: Gone tomorrow
Value: Gone tomorrow

Days Text - Multiple Days LeftVariable

Text to display for items leaving in multiple days when Use Days Left is enabled

Target: TEXT_DAYS
Default: Gone in {0} days
Value: Gone in {0} days

Collections - OrderVariable

Order of collections in Plex

Target: PLEX_COLLECTION_ORDER
Default: asc|desc

Collections - NamesVariable

Comma-separated list of names of the collections to be reordered

Target: PROCESS_COLLECTIONS
Default: Leaving Soon
Value: Movies Leaving Soon, TV Programmes Leaving Soon

LanguageVariable

Language for the overlay text

Target: LANGUAGE
Default: en-US
Value: en-US

Cron ScheduleVariable

Cron schedule to run the script (Now powered by Supercronic)

Target: CRON_SCHEDULE
Default: 0 */8 * * *
Value: 0 */8 * * *

Run On CreationVariable

Run the script immediately on Docker boot

Target: RUN_ON_CREATION
Default: true|false

Internal Image Save PathVariable

Internal path to save images. Not recommended to change.

Target: IMAGE_SAVE_PATH
Default: /images
Value: /images

Internal Original Image Save PathVariable

Internal path to save original images. Not recommended to change.

Target: ORIGINAL_IMAGE_PATH
Default: /images/originals
Value: /images/originals

Internal Temporary Image Save PathVariable

Internal path to save temporary images. Not recommended to change.

Target: TEMP_IMAGE_PATH
Default: /images/temp
Value: /images/temp

Internal Font PathVariable

Internal path to saved font file. Not recommended to change.

Target: FONT_PATH
Default: /fonts/font.ttf
Value: /fonts/font.ttf

PUIDVariable

User ID for the container (Default 99 for 'nobody')

Default: 99
Value: 99

PGIDVariable

Group ID for the container (Default 100 for 'users')

Default: 100
Value: 100

UMASKVariable

UMASK for file permissions

Default: 022
Value: 022

Links

Template Support Docker Hub Project

Details

Repository

gsariev/maintainerr-overlay-helperr:latest

Registry

https://hub.docker.com/r/gsariev/maintainerr-overlay-helperr

Last Updated2026-05-03

First Seen2025-05-08

Run Maintainerr-Overlay-Helperr on Unraid.

Maintainerr-Overlay-Helperr is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS