Clearclutter

- **Sync scope**: scan photos only, videos only, or everything — selector in
the top bar next to Sync (CLI: `clearclutter scan --kind photos|videos`).
A photos pass skips all video I/O; missing-file detection stays
whole-drive
- **Bulk "Keep ★, bin rest — all"** in the Groups view: applies the keeper
resolution to every unverified group matching the current filters (e.g.
Exact + Photos) in one confirmed action, with a dry-run count first and a
warning when the filter includes non-byte-identical matches. Groups whose
keeper is no longer active are skipped so a bulk pass can never queue the
last remaining copy

- **Background jobs panel** (left pane): sync, apply and face detection run as
jobs with live progress and pause / resume / cancel — keep browsing while
they run
- **Disk bandwidth cap** (Full speed / Balanced / Gentle selector): scans no
longer starve the UI of disk I/O on slow drives
- **Video review, fixed**: HTTP Range streaming (instant playback + seeking in
large videos), hover-to-play previews in the timeline, in-card muted players
with scrubbing in group review (double-click for the lightbox), and closing
the lightbox actually stops playback/audio
- **Live Photo grouping fix**: images from *different* Live Photos
(ContentIdentifiers) can no longer be chained by perceptual match — one HEIC
no longer collects every .MOV shot at the same place/time
- **Groups review filters**: Photos / Videos filter alongside the existing
type chips and sort options
- **Bulk actions in one request**: tag / bin / move for a whole selection is a
single call (was one HTTP request per file) with immediate feedback;
"Keep ★, bin rest" buttons show "Queuing…" instantly
- **Opt-in permanent delete**: Pending actions can delete binned files
directly instead of moving to ClearClutter_bin/ (explicit checkbox +
confirmation, not undoable; default remains non-destructive)
- **People**: merge face clusters from the UI; face detection is started from
the People view (no separate CLI step needed)
- **One command**: `clearclutter /path/to/drive` serves directly; scanning and
face detection are triggered from the UI
- **Tags** moved out of the left nav into a timeline filter dropdown
- Faster: schema/migrations run once per process instead of on every request,
file pages enrich tags/decisions in 2 queries instead of 2 per file, small
images are read once (hash + decode from one read), thumbnails get long-term
cache headers
- Top bar warns when ffmpeg / exiftool are missing (video thumbnails,
Live Photo pairing)

- Sampled hashing for files >64 MB (8 MB I/O per video instead of full read) + fast JPEG decode — large-library scans dramatically faster
- Scanner commits every 100 files: safe concurrent serve, steady progress, "database is locked" fixed
- RAW thumbnails/previews via embedded JPEG (exiftool); video frame thumbnails via ffmpeg (optional)
- Favourites: heart photos, Favourites view in the nav
- Group review opens inline (sidebar stays visible) instead of a modal
- Timeline renders incrementally with content-visibility — smooth at tens of thousands of photos

- Batched scanning: committed batches with per-batch exiftool metadata, live rate/ETA, listing progress, safe interruption
- Groups rebuild periodically during a UI sync — review starts while the scan runs
- `serve <root>` registers the drive root, so fresh drives can be scanned entirely from the UI
- `scan --batch-size` flag; live count updates in the UI during sync
- Notice before the one-time InsightFace model download (~300 MB to ~/.insightface)

Initial release.

- Scanner: incremental drive indexing (xxh3 + perceptual hash + EXIF via
exiftool/Pillow), sharded thumbnails, on-drive workspace (`<root>/.clearclutter/`)
- Grouping: exact hash, phash similarity (tunable), Apple Live Photo pairing,
video time windows, singles-as-groups, manual splits with never-pair rules
- Verify workflow: per-file verified status, unverified review queue with
auto-advance, keeper suggestion scoring (format / resolution / metadata / size)
- Google-Photos-style web UI: justified timeline, date + shift range selection,
People (optional InsightFace clustering), Places (GPS grid), tags, lightbox
- Non-destructive actions: bin/move queue with dry run, per-file and batch undo,
bin view with restore/remove, broken-link reconciliation by content hash