{"id":17858506,"url":"https://github.com/buried-in-code/mediux-posters","last_synced_at":"2025-09-30T16:30:36.709Z","repository":{"id":258223195,"uuid":"873356939","full_name":"Buried-In-Code/Mediux-Posters","owner":"Buried-In-Code","description":null,"archived":false,"fork":false,"pushed_at":"2025-01-05T10:02:27.000Z","size":236,"stargazers_count":6,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-20T06:57:01.326Z","etag":null,"topics":["jellyfin","mediux","plex","posters","python-3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Buried-In-Code.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-16T03:07:16.000Z","updated_at":"2025-01-16T03:42:43.000Z","dependencies_parsed_at":"2024-10-18T03:30:33.208Z","dependency_job_id":"7768b3cd-2812-4880-83cb-c5c854e3b3f9","html_url":"https://github.com/Buried-In-Code/Mediux-Posters","commit_stats":{"total_commits":6,"total_committers":1,"mean_commits":6.0,"dds":0.0,"last_synced_commit":"9ed5a840465120e240c7f436d05ce92e1023933b"},"previous_names":["buried-in-code/mediux-posters"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buried-In-Code%2FMediux-Posters","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buried-In-Code%2FMediux-Posters/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buried-In-Code%2FMediux-Posters/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Buried-In-Code%2FMediux-Posters/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Buried-In-Code","download_url":"https://codeload.github.com/Buried-In-Code/Mediux-Posters/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234750708,"owners_count":18880922,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jellyfin","mediux","plex","posters","python-3"],"created_at":"2024-10-28T05:07:48.260Z","updated_at":"2025-09-30T16:30:36.703Z","avatar_url":"https://github.com/Buried-In-Code.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mediux Posters\n\n[![PyPI - Python](https://img.shields.io/pypi/pyversions/Mediux-Posters.svg?logo=PyPI\u0026label=Python\u0026style=flat-square)](https://pypi.python.org/pypi/Mediux-Posters/)\n[![PyPI - Status](https://img.shields.io/pypi/status/Mediux-Posters.svg?logo=PyPI\u0026label=Status\u0026style=flat-square)](https://pypi.python.org/pypi/Mediux-Posters/)\n[![PyPI - Version](https://img.shields.io/pypi/v/Mediux-Posters.svg?logo=PyPI\u0026label=Version\u0026style=flat-square)](https://pypi.python.org/pypi/Mediux-Posters/)\n[![PyPI - License](https://img.shields.io/pypi/l/Mediux-Posters.svg?logo=PyPI\u0026label=License\u0026style=flat-square)](https://opensource.org/licenses/MIT)\n\n[![Pre-Commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026style=flat-square)](https://github.com/pre-commit/pre-commit)\n[![Ruff](https://img.shields.io/badge/ruff-enabled-brightgreen?logo=ruff\u0026style=flat-square)](https://github.com/astral-sh/ruff)\n\n[![Github - Contributors](https://img.shields.io/github/contributors/Buried-In-Code/Mediux-Posters.svg?logo=Github\u0026label=Contributors\u0026style=flat-square)](https://github.com/Buried-In-Code/Mediux-Posters/graphs/contributors)\n\nFetches Show, Movie, and Collection cover art from Mediux and updates Plex/Jellyfin using TMDB IDs.\n\n_Jellyfin Collections are not yet supported._\n\n## Installation\n\n### Pipx\n\n1. Ensure you have [Pipx](https://pipx.pypa.io/stable/) installed: `pipx --version`\n2. Install the project: `pipx install Mediux-Posters`\n\n## Usage\n\n\u003cdetails\u003e\u003csummary\u003eMediux-Posters Commands\u003c/summary\u003e\n\n  \u003c!-- RICH-CODEX hide_command: true --\u003e\n  ![`uv run Mediux-Posters --help`](docs/img/mediux-posters_commands.svg)\n\n\u003c/details\u003e\n\u003cdetails\u003e\u003csummary\u003eMediux-Posters sync\u003c/summary\u003e\n\n  \u003c!-- RICH-CODEX hide_command: true --\u003e\n  ![`uv run Mediux-Posters sync --help`](docs/img/mediux-posters_sync.svg)\n\n\u003c/details\u003e\n\u003cdetails\u003e\u003csummary\u003eMediux-Posters show\u003c/summary\u003e\n\n  \u003c!-- RICH-CODEX hide_command: true --\u003e\n  ![`uv run Mediux-Posters show --help`](docs/img/mediux-posters_show.svg)\n\n\u003c/details\u003e\n\u003cdetails\u003e\u003csummary\u003eMediux-Posters collection\u003c/summary\u003e\n\n  \u003c!-- RICH-CODEX hide_command: true --\u003e\n  ![`uv run Mediux-Posters collection --help`](docs/img/mediux-posters_collection.svg)\n\n\u003c/details\u003e\n\u003cdetails\u003e\u003csummary\u003eMediux-Posters movie\u003c/summary\u003e\n\n  \u003c!-- RICH-CODEX hide_command: true --\u003e\n  ![`uv run Mediux-Posters movie --help`](docs/img/mediux-posters_movie.svg)\n\n\u003c/details\u003e\n\u003cdetails\u003e\u003csummary\u003eMediux-Posters set\u003c/summary\u003e\n\n  \u003c!-- RICH-CODEX hide_command: true --\u003e\n  ![`uv run Mediux-Posters set --help`](docs/img/mediux-posters_set.svg)\n\n\u003c/details\u003e\n\u003cdetails\u003e\u003csummary\u003eMediux-Posters settings\u003c/summary\u003e\n\n  \u003c!-- RICH-CODEX hide_command: true --\u003e\n  ![`uv run Mediux-Posters settings --help`](docs/img/mediux-posters_settings.svg)\n\n\u003c/details\u003e\n\n## Notes\n\n- When running a sync/show/collection/movie it will keep downloading sets until all the needed posters are found.\n  - **Show:** Poster and Backdrop\n  - **Season:** Poster\n  - **Episode:** Title Card\n  - **Collection:** Poster and Backdrop\n  - **Movie:** Poster and Backdrop\n- To enable support for Collections in Plex, each Collection needs to have a label with its tmdb-id, in the format of `tmdb-\u003cnumber\u003e`\\\n  If using Kometa, refer to [this comment](https://github.com/Buried-In-Code/Mediux-Posters/issues/12#issuecomment-2622002859) to have Kometa add these labels.\n\n## Settings\n\nTo set Plex and/or Jellyfin details, update the file: `~/.config/mediux-posters/settings.toml`.\nFile will be created on first run.\n\n### Example File\n\n```toml\nexclude_usernames = []\nkometa_integration = false\nonly_priority_usernames = false\npriority_usernames = []\n\n[jellyfin]\nbase_url = \"http://127.0.0.1:8096\"\ntoken = \"\u003cToken\u003e\"\n\n[plex]\nbase_url = \"http://127.0.0.1:32400\"\ntoken = \"\u003cToken\u003e\"\n```\n\n### Details\n\n- `exclude_usernames`\n\n  A list of usernames whose sets should be ignored when running a sync.\n\n- `kometa_integration`\n\n  If enabled, will remove the `Overlay` label from any media Mediux-Posters uploads a poster/backdrop/title-card to.\n\n- `only_priority_usernames`\n\n  A boolean flag that limits downloading sets to ones created by the users specified in `priority_usernames`.\n  If set to `false`, all sets will be considered unless explicitly excluded in `exclude_usernames`.\n\n- `priority_usernames`\n\n  A list of usernames whose sets should take priority when running a sync.\n  If `only_priority_usernames` is set to `true`, only sets from these users will be used.\n\n## Socials\n\n[![Social - Fosstodon](https://img.shields.io/badge/%40BuriedInCode-teal?label=Fosstodon\u0026logo=mastodon\u0026style=for-the-badge)](https://fosstodon.org/@BuriedInCode)\\\n[![Social - Matrix](https://img.shields.io/matrix/The-Dev-Environment:matrix.org?label=The-Dev-Environment\u0026logo=matrix\u0026style=for-the-badge)](https://matrix.to/#/#The-Dev-Environment:matrix.org)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburied-in-code%2Fmediux-posters","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fburied-in-code%2Fmediux-posters","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburied-in-code%2Fmediux-posters/lists"}