Homelabtoolkit v2

README.md

@@ -16,6 +16,8 @@ UI, served by a FastAPI backend.
   per-studio artwork resets.
 - **User Favorites** — browse collections with per-user watched status, prune
   watched items, and top up with recommendations (dry-run by default).
+- **Weekly Preroll Rotation** — schedule your Emby preroll folder to rotate once
+  per week from the Settings page, with a manual "Run now" action for testing.
 
 ### Navidrome
 - **Music Library** — browse artists and albums over the Subsonic API.
@@ -41,13 +43,19 @@ UI, served by a FastAPI backend.
 | `NAVIDROME_USER` | Navidrome username |
 | `NAVIDROME_PASSWORD` | Navidrome password |
 | `MUSIC_ROOT` | Path to the music library for the Cover Manager |
+| `PREROLL_ENABLED` | Enable the weekly preroll task by default |
+| `PREROLL_ACTIVE_DIR` / `PREROLL_INACTIVE_DIR` | Mounted preroll folders to rotate between |
+| `PREROLL_STATE_FILE` | Where weekly rotation state is stored |
+| `PREROLL_WEEKDAY` / `PREROLL_TIME` | Default weekly schedule for the preroll task |
 | `TMDB_BEARER_TOKEN` / `TMDB_API_KEY` | Optional artwork providers |
 | `GOOGLE_CUSTOM_SEARCH_API_KEY` / `..._ENGINE_ID` | Optional artwork search |
 
 ## Run with Docker (recommended)
 
 1. Edit `docker-compose.yml` with your Emby/Navidrome details and mount your music
-   share to match `MUSIC_ROOT`.
+   share to match `MUSIC_ROOT`. If you want weekly preroll rotation, also mount
+   the active/inactive preroll folders and either set the `PREROLL_*` defaults
+   there or configure the task in the app's Settings page.
 2. Build and run:
    ```bash
    docker compose up -d --build