Multi-source rating overlays for your Plex media library
Automatically enhance your movie and TV show posters with beautiful rating badges from IMDb, TMDB, and Rotten Tomatoes
Kometizarr is a self-hosted Docker application that automatically applies rating badges to your Plex library posters. It fetches ratings from multiple sources and creates beautiful overlay badges, all while keeping your original posters safely backed up.
Displays ratings from IMDb, TMDB, Rotten Tomatoes (Critic & Audience) in one beautiful badge on your posters.
Your original posters are automatically backed up before any changes. Restore them anytime with a single click.
Create and manage Plex collections by decade, studio, network, or keyword. Perfect for organizing your library.
Choose where rating badges appear on your posters: top-left, top-right, bottom-left, or bottom-right.
Update all overlays with fresh ratings anytime. Uses backed up originals, so you never lose quality.
Modern, responsive web UI with real-time progress tracking. Manage your entire library from your browser.
Get up and running in minutes with Docker Compose
# Clone the repository git clone https://github.com/P2Chill/kometizarr.git cd kometizarr # Copy and configure environment variables cp .env.example .env # Edit .env with your Plex credentials and API keys # Start with Docker Compose docker-compose up -d # Access the Web UI open http://localhost:3001
📖 Full installation guide and API key setup available on GitHub
Navigate to http://localhost:3000 in your browser to access the Kometizarr dashboard.
Choose which Plex library you want to enhance (Movies, TV Shows, etc.).
Select badge position (northwest, northeast, southwest, southeast) and whether to force reprocess existing items.
Click "Process Library" and watch real-time progress as rating overlays are applied. Original posters are automatically backed up.
Use the "Restore Originals" button to remove overlays and restore your original posters from backup.
See Kometizarr in action
