Implement playlist versioning and watcher thread

Introduces a versioned playlist with thread-safe updates and a background watcher for live rotation content changes. Updates API to return playlist version and items, refactors config for scan interval, and improves player.js to handle playlist updates and robust media advancement. Removes unused video extension, updates styles, and cleans up rotation demo files.

Took 1 hour 27 minutes

Author: ProtoXCode

README.md

@@ -1,233 +1,101 @@
-# 🖥️ Kiosk Rotation Engine (MVP)
+# 🖥️ Kiosk Rotation Engine
 
-> **A dead‑simple, self‑hosted rotation engine for view‑only screens**  
-> Built for factory floors, TVs, kiosks, and any display where *scrolling and 
-> clicking are illegal*.
+A lightweight, self‑hosted digital signage engine for kiosk displays.
 
-This project provides a **fire‑and‑forget kiosk server** that automatically 
-discovers content from disk and rotates it fullscreen in a browser.
-
-No accounts. No editors. No cloud. No vendor lock‑in.
-
-Just drop content in a folder and let it play.
+Drop files in a folder. Screens update automatically. No cloud. No accounts.
+No nonsense.
 
 ---
 
-## 🎯 What this is
-
-This is **not** a full digital signage platform.
-
-It is:
-- A **local kiosk server**
-- With **filesystem‑driven content discovery**
-- Designed for **non‑interactive TVs / monitors**
-- Optimized for **industrial / factory environments**
+## ✨ Features
 
-The goal is simple:
-
-> **If it’s a webpage, image, or HTML file — it can be shown on a screen.**
+* 📂 Folder‑based rotation (images, videos, HTML)
+* 🔄 Live updates — viewers refresh automatically
+* 🧠 Playlist versioning (safe, flicker‑free updates)
+* 🖥️ Fullscreen kiosk player (browser‑based)
+* 🛡️ Fault‑tolerant (missing files won’t crash playback)
+* ⚙️ Simple YAML configuration
+* 🐧 Works on Linux, Windows, Raspberry Pi
 
 ---
 
-## 🧠 Design philosophy (KISS, intentionally)
-
-- The **screen is dumb** (just a browser)
-- The **rotation logic is simple**
-- The **content owns itself**
-- Humans should be able to add content **without touching Python**
-
-This avoids:
-- Over‑engineering
-- Vendor lock‑in
-- UI builders nobody likes
-- Becoming “the TV admin guy”
+## 🚀 Quick Start
 
----
-
-## 📁 Core concept: the `rotation/` folder
-
-The kiosk automatically scans a folder and turns its contents into 
-fullscreen views.
-
-```
-rotation/
-├── onsite.url
-├── production.url
-├── safety.html
-├── christmas.html
-├── announcement.png
-├── map.jpg
-├── maintenance/
-│   └── index.html
+```bash
+git clone https://github.com/ProtoXCode/Kiosk-Rotation-Engine.git
+cd kiosk-rotation-engine
+pip install -r requirements.txt
+python run.py
 ```
 
-Anything placed here becomes part of the rotation.
-
-No restart required (depending on scan interval).
-
----
-
-## 🧩 Supported content types (MVP)
-
-### 🌐 `.url` files → Web dashboards
-
-A text file containing a single URL:
+Open in a browser:
 
 ```
-http://onsite.local/onsite
+http://<host>:8080
 ```
 
-Rendered as:
-- Fullscreen iframe
-
-Perfect for:
-- Dash dashboards
-- ERP views
-- Grafana
-- Internal tools
+(Use fullscreen / kiosk mode for production screens.)
 
 ---
 
-### 📄 `.html` files → Static pages
+## 📁 Adding Content
 
-Dropped directly into `rotation/`.
+Put files into the **rotation directory** (default: `rotation/`).
 
-Rendered as:
-- Fullscreen iframe
+Supported formats:
 
-Supports:
-- CSS
-- JavaScript
-- Animations
-- Videos
+* Images: `.jpg`, `.png`, `.jpeg`
+* HEIC / HEIF: `.heic`, `.heif` (auto‑converted to JPEG)
+* Video: `.mp4`, `.webm`
+* HTML: `.html` (rendered via iframe)
+* URL: `'.url` (rendered via iframe, target site must allow to be built in)
 
-Ideal for:
-- Safety notices
-- Announcements
-- Event info
+Changes are picked up automatically — no reload, no restart.
 
 ---
 
-### 🖼 Images (`.png`, `.jpg`, `.webp`) → Posters
+## ⚙️ Configuration (`config.yaml`)
 
-Rendered as:
-- Fullscreen, centered image
+Example:
 
-Ideal for:
-- Posters
-- Floor maps
-- Evacuation plans
-- One‑off announcements
-
----
-
-### 📁 Folders with `index.html`
-
-```
-rotation/maintenance/index.html
+```yaml
+rotation:
+  media_directory: /srv/kiosk/rotation
+  default_duration: 10
+  image_duration: 10
+  playlist_scan: 60
+  video_mute: true
 ```
 
-Rendered as:
-- Fullscreen mini‑site
-
-Allows multi‑file HTML content with assets.
+* **media_directory** – Folder watched for content
+* **default_duration** – Fallback duration (seconds)
+* **image_duration** – Image display time
+* **playlist_scan** – Backend rescan interval (seconds)
+* **video_mute** – Start videos muted
 
 ---
 
-## 🔁 Rotation behavior (MVP)
+## 🧠 How It Works (Short Version)
 
-- Content rotates automatically
-- Fixed duration per view (configurable)
-- Fullscreen only
-- No scrolling
-- No user input
+* Backend scans the rotation folder on a fixed interval
+* Builds a versioned playlist
+* Viewers fetch the playlist and play it sequentially
+* Updates are applied cleanly on the next loop
 
-The kiosk is **view‑only by design**.
+No polling storms. No race conditions. No broken screens.
 
 ---
 
-## 🖥️ Intended usage
+## ⚠️ Design Notes
 
-- Factory floor TVs
-- Production overview screens
-- Safety / evacuation displays
-- Office status boards
-- Any screen that should *just show things*
-
-The kiosk runs via:
-- Browser (Chrome / Edge / Firefox)
-- Kiosk / fullscreen mode recommended
-
----
-
-## 🚧 What this MVP does NOT include (by design)
-
-Not included **yet**:
-- UI manager
-- Authentication
-- User roles
-- Screen grouping
-- Per‑view schedules
-- Remote control
-
-These are **explicitly postponed** to keep the MVP clean.
-
----
-
-## 🛣️ Planned next steps (post‑MVP)
-
-Once the rotation engine is stable:
-
-### 🧑‍💼 Manager UI (NiceGUI 3.0)
-- CRUD for rotation content
-- Upload / delete files
-- Enable / disable views
-- Adjust rotation timing
-
-### 📱 Remote control mode
-- Use phone/tablet to temporarily take control
-- Select a specific view (e.g. team meeting)
-- Return to auto‑rotation
-
-### 🚨 Emergency override
-- Force evacuation / safety view
-- Pause rotation
-
-All of these builds **on top of the MVP**, not inside it.
-
----
-
-## 🧠 Why this exists
-
-Most digital signage solutions:
-- Are cloud‑locked
-- Cost per screen
-- Don’t integrate cleanly with ERP systems
-- Are painful to maintain long‑term
-
-This project exists to provide:
-- A local‑first alternative
-- With clean system boundaries
-- That scales without turning into a platform monster
-
----
-
-## 🧑‍💻 Author
-
-Built by **Tom Erik Harnes**  
-Focused on practical, industrially grounded software that survives 
-real environments.
+* No authentication (intended for trusted networks)
+* No admin UI — filesystem is the source of truth
+* Not designed for public internet exposure
 
 ---
 
-## 🏄‍♂️ Final note
-
-This project is intentionally boring.
+## 📜 License
 
-Boring means:
-- Stable
-- Predictable
-- Easy to explain
-- Hard to replace
+MIT License
 
-That’s exactly what you want on a factory wall.
+Use it, break it, improve it — just don’t put it behind a paywall 😎