Skip to content

Buried-In-Code/Mediux-Posters

Repository files navigation

Mediux Posters

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

prek Ruff Ty

Linting Testing Publishing

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

mediux-posters sync

uv run mediux-posters sync --help

mediux-posters media

uv run mediux-posters media --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>"

[mediux]
base_url = "https://images.mediux.io"
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

Languages