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

mediux-posters help

mediux-posters sync

mediux-posters sync command help

mediux-posters media

mediux-posters media help

mediux-posters set

mediux-posters set help

mediux-posters settings

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, Collection, Movie: Poster, Backdrop, Logo (and Album/SquareArt only on Plex)
    • Season: Poster, Backdrop
    • Episode: TitleCard, 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 = []

[covers]
path = "~/.cache/mediux-posters/covers"
store = true

[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

  • covers.path

    Folder location as to where to store downloaded covers.

  • covers.store

    Wether to store the images in the cache between runs, useful when running multiple services to not have to redownload images.

  • 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 - Matrix

Project links

Data verified by PyPI on Jul 17, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Buried-In-Code from gravatar.com Buried-In-Code

Credits

Author: BuriedInCode

GitHub Statistics

Data verified by PyPI on Jul 17, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mediux_posters-2026.1.1.tar.gz (2.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mediux_posters-2026.1.1-py3-none-any.whl (34.6 kB view details)

Uploaded Python 3

File details

Details for the file mediux_posters-2026.1.1.tar.gz.

File metadata

  • Download URL: mediux_posters-2026.1.1.tar.gz
  • Upload date:
  • Size: 2.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for mediux_posters-2026.1.1.tar.gz
Algorithm Hash digest
SHA256 3a5110e15a2840b5d5f27d331abebe13b6b8ea280087b711bb734431bef6fae8
MD5 833acb1cc3ed94b240dd17d82e7eeb5d
BLAKE2b-256 35dbb28677ce12e8a5499a3acbbb63173f0b6c30e6be4697bbe29d14200c5b84

See more details on using hashes here.

Provenance

The following attestation bundles were made for mediux_posters-2026.1.1.tar.gz:

Publisher: publishing.yaml on Buried-In-Code/Mediux-Posters

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mediux_posters-2026.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mediux_posters-2026.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3f9eaee777b1c1b5f4e3a8248cad57df5820dbfd15cfbe890341c88d3c89e4ce
MD5 dd3bb6700d397846951ec60607d74669
BLAKE2b-256 5c3586c6a5062d39b53c30e6af8121884cee546134fe21ba237933bafd6233a6

See more details on using hashes here.

Provenance

The following attestation bundles were made for mediux_posters-2026.1.1-py3-none-any.whl:

Publisher: publishing.yaml on Buried-In-Code/Mediux-Posters

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

2026.1.1 This release

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page