Skip to content

Fetches Show, Movie, and Collection cover art from Mediux and updates Plex/Jellyfin using TMDB IDs.

License

Notifications You must be signed in to change notification settings

Buried-In-Code/Mediux-Posters

Repository files navigation

Mediux Posters

PyPI - Python PyPI - Status PyPI - Version PyPI - License

Pre-Commit Ruff

Github - Contributors

Fetches Show, Movie, and Collection cover art from Mediux and updates Plex/Jellyfin using TMDB IDs.

Jellyfin Collections are not yet supported.

Installation

Pipx

  1. Ensure you have Pipx installed: pipx --version
  2. Install the project: pipx install Mediux-Posters

Usage

Mediux-Posters Commands

uv run Mediux-Posters --help

Mediux-Posters sync

uv run Mediux-Posters sync --help

Mediux-Posters show

uv run Mediux-Posters show --help

Mediux-Posters collection

uv run Mediux-Posters collection --help

Mediux-Posters movie

uv run Mediux-Posters movie --help

Mediux-Posters set

uv run Mediux-Posters set --help

Mediux-Posters settings

uv run Mediux-Posters settings --help

Notes

  • When running a sync/show/collection/movie it will keep downloading sets until all the needed posters are found.
    • Show: Poster and Backdrop
    • Season: Poster
    • Episode: Title Card
    • Collection: Poster and Backdrop
    • Movie: Poster and Backdrop
  • To enable support for Collections in Plex, each Collection needs to have a label with its tmdb-id, in the format of tmdb-<number>
    If using Kometa, refer to this comment to have Kometa add these labels.

Settings

To set Plex and/or Jellyfin details, update the file: ~/.config/mediux-posters/settings.toml. File will be created on first run.

Example File

exclude_usernames = []
kometa_integration = false
only_priority_usernames = false
priority_usernames = []

[jellyfin]
base_url = "http://127.0.0.1:8096"
token = "<Token>"

[plex]
base_url = "http://127.0.0.1:32400"
token = "<Token>"

Details

  • exclude_usernames

    A list of usernames whose sets should be ignored when running a sync.

  • kometa_integration

    If enabled, will remove the Overlay label from any media Mediux-Posters uploads a poster/backdrop/title-card to.

  • only_priority_usernames

    A boolean flag that limits downloading sets to ones created by the users specified in priority_usernames. If set to false, all sets will be considered unless explicitly excluded in exclude_usernames.

  • priority_usernames

    A list of usernames whose sets should take priority when running a sync. If only_priority_usernames is set to true, only sets from these users will be used.

Socials

Social - Fosstodon
Social - Matrix

About

Fetches Show, Movie, and Collection cover art from Mediux and updates Plex/Jellyfin using TMDB IDs.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •  

Languages