A web app for scheduling Plex Home collection layouts. Create scheduled layouts for specific date ranges - perfect for featuring horror collections in October, holiday movies in December, or Oscar nominees during awards season.
- Scheduled Layouts - Save a complete home layout and schedule it for a date range
- Promotions - Boost specific collections to the top without changing your entire layout
- Repeat Yearly - Schedules automatically repeat every year (set it and forget it)
- Drag and Drop - Reorder collections visually
- Collection Pool - Pull any plex or kometa collection into your home hub's scheduled layout (even kometa collections that aren't currently active in plex)
- Visibility Toggles - Control Home, Shared Home, and Friends visibility separately
- Preview Mode - Time-travel to see what your home will look like at any date
- Kometa Integration - Detects schedule conflicts and can auto-fix them
- Dry-run Mode - Preview changes without touching Plex (enabled by default)
- Snapshots & Rollback - One-click restore if something goes wrong
You'll need Docker and your Plex token (how to find it).
git clone https://github.com/Shlawpers/Curatorr.git
cd Curatorr
cp .env.example .env
# Edit .env with your PLEX_URL and PLEX_TOKEN
docker compose up -d
# Open http://localhost:3000Edit your .env file:
| Variable | Required | Description |
|---|---|---|
PLEX_URL |
Yes | Your Plex server URL |
PLEX_TOKEN |
Yes | Your Plex auth token |
APPLY_MODE |
No | dry-run (default) or apply |
TZ |
No | Your timezone, e.g. America/New_York |
See GUIDE.md for additional options including password authentication and Kometa integration.
- Visibility changes may not work on older Plex versions - tested on latest stable PMS
- Kometa-only collections won't appear in Plex until Kometa creates them - missing collections are handled gracefully
- Built-in hubs (Recently Added, Genres, etc.) can only be hidden, not deleted
- User Guide - Detailed usage instructions, tips, and troubleshooting
- Plex Hub API Reference - Technical reference for contributors (critical reading before modifying hub logic)
- Hub reordering recovery pattern inspired by Agregarr - their solution to Plex's float precision convergence issue saved significant debugging time
MIT