Media Reviewer

A lightweight, mobile-first web application for reviewing and sorting large sets of images and videos. No separate database required — companion sidecar files track item state on disk.

Features

• Add media folders via the web UI; state persists in ~/.mediareviewer
• Grid view with thumbnail previews and per-status counts
• Fullscreen review mode with keyboard shortcuts, swipe navigation, and auto-advance
• Lock, trash, seen, and unseen companion-file actions with single-level undo
• Batch multi-select actions (long-press to enter selection mode)
• Async deletion queue with progress tracking and cancellation
• Configurable video preload size, light/dark/system theme

Documentation

• API Reference — full endpoint specification
• Architecture Diagrams — system component and data-flow diagrams
• Lint Notes — coding anti-patterns to avoid

Quick Start

# Clone and start development servers
git clone https://github.com/mdmoore25404/mediareviewer.git
cd mediareviewer
./dev.sh start

See the README for full setup instructions including Docker deployment.

License

Business Source License 1.1 — converts to Apache 2.0 on 2030-04-15.