Files
wiki/Catalogue-Self-Hosted/apps/app-posterizarr.md
T
2026-06-09 18:40:21 +02:00

115 lines
4.8 KiB
Markdown

---
title: Posterizarr
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, arr, poster, jaquette, automatis]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=*arr, https://github.com/anteo/posterizarr]
---
# 🎬 Posterizarr
> Générateur automatique de posters et jaquettes personnalisées pour Sonarr, Radarr, Lidarr : récupère les artworks depuis Fanart.tv, TMDB, TVDB, applique des overlays (certification, résolution, studio), et range tout pour Jellyfin/Plex/Emby.
## 📋 Informations Générales
| Attribut | Valeur |
|----------|--------|
| **Nom** | Posterizarr |
| **Slug** | posterizarr |
| **Description** | Génération batch de posters personnalisés pour la stack *arr, avec overlays texte |
| **Site officiel** | https://posterizarr.com |
| **Repository** | https://github.com/anteo/posterizarr |
| **Stars** | 881 ⭐ |
| **Licence** | MIT |
| **Langage principal** | Python |
| **Catégorie** | *arr (media management) |
| **Tags** | [catalogue, arr, poster, jaquette, automatis] |
## 📝 Description
**Posterizarr** est l'outil qu'on découvre après des mois à customiser ses posters un par un dans Photoshop (ou à laisser les jaquettes par défaut de TMDB, qui sont souvent... moyennes). Posterizarr automatise tout : récupération multi-sources, application d'overlays, et rangement dans la bibliothèque.
Fonctionnalités principales :
- **Multi-sources** : Fanart.tv (HD, UHD, logos, cleararts), TMDB, TVDB, MusicBrainz, IMDb.
- **Overlays personnalisables** : ajoute en coin/bas un badge "4K", "HDR", "Dolby Vision", "Atmos", "Multi-Audio", "REMUX", "REMUX-2160p", etc.
- **Templates** : le script applique un template par défaut (série, film, animé, sport) ou un custom.
- **Fonds alternatifs** : pour les films/séries dont la jaquette TMDB est moche, Fanart propose souvent mieux.
- **Batch processing** : scan de toute la bibliothèque, regénération en masse la nuit.
- **Webhooks** : déclenché après un téléchargement Sonarr/Radarr, regénère le poster du nouveau média.
- **Cache intelligent** : ne retélécharge pas un poster déjà en cache, accélère les passes suivantes.
- **Support multi-langues** : télécharge le titre localisé, l'overlay reste en français par défaut.
L'UI est minimaliste (c'est un script avec dashboard web léger), l'essentiel est dans la config.
## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
services:
posterizarr:
image: ghcr.io/anteo/posterizarr:latest
container_name: posterizarr
restart: unless-stopped
environment:
- TZ=Europe/Paris
- TMDB_API_KEY=xxxxxxxxxxxxxxxx
- FANART_API_KEY=xxxxxxxxxxxxxxxx
- TVDB_API_KEY=xxxxxxxxxxxxxxxx
- SONARR_URL=http://sonarr:8989
- SONARR_API_KEY=xxxxxxxxxxxxxxxx
- RADARR_URL=http://radarr:7878
- RADARR_API_KEY=xxxxxxxxxxxxxxxx
volumes:
- ./config:/app/config
- /mnt/media:/media
ports:
- "8010:8010"
```
### Installation manuelle
Python 3.10+, `Pillow` (PIL), `requests`. `git clone`, `pip install -r requirements.txt`, `python posterizarr.py --run`.
## ⚙️ Configuration
- **API keys** : TMDB (gratuite), Fanart.tv (gratuite, obligatoire), TVDB (compte dev).
- **Templates** : modifier les JSON dans `/config/templates/`, ajouter/supprimer des overlays.
- **Cibles** : par défaut `Movies/` et `TV/`, configurable pour matcher votre structure.
- **Skip existants** : option pour ne pas écraser un poster customisé manuellement.
- **Cron** : configurer un cron quotidien pour regénérer les posters des nouveaux médias.
- **Reverse proxy** : optionnel, l'UI web est light, l'API suffit.
## 🔗 Alternatives
- **Kometa (ex Plex Meta Manager)** — équivalent, plus mature, plus complexe à configurer.
- **Plex/Jellyfin natif** — pas d'overlays, jaquettes TMDB par défaut.
- **Photoshop/GIMP manuel** — qualité max, mais à 5000 films c'est impossible.
- **Artwork Beast** — projet plus jeune, moins de sources.
- **Upload-Poster (Sonarr plugin)** — un par un, pas de batch.
## 🔒 Sécurité
- **API keys en clair** dans la config, permissions 600 sur le fichier.
- **Volumes** : `/media` monté en read-only, c'est suffisant (Posterizarr écrit dans `/config`).
- **Pas d'auth native** : l'UI web est read-only, mais à exposer derrière Authelia par principe.
- **Logs** : contenir les titres traités, modérés.
- **Rate limit Fanart/TMDB** : respecter les quotas, sinon ban temporaire.
## 📚 Ressources
- Site officiel : https://posterizarr.com
- Documentation : https://docs.posterizarr.com
- Wiki *arr : https://wiki.servarr.com
- Kometa : https://kometa.wiki
## 🔗 Pages Liées
- [[cat-arr]]
- [[app-sonarr]]
- [[app-radarr]]
- [[app-lidarr]]
- [[app-jellyfin]]
- [[app-plex]]
- [[app-emby]]
- [[app-kometa]]
- [[app-traefik]]
- [[app-authelia]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]