diff --git a/.gitignore b/.gitignore
index 795c88e..b55708f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,9 @@
 __pycache__/
 *.pyc
 photon_journal.jsonl
+photon_failures.jsonl
+photon_audits.jsonl
+photon_phash.json
+photon_folder.json
+photon_categories.json
+.claude/
diff --git a/README.md b/README.md
index 37123b0..cb91371 100644
--- a/README.md
+++ b/README.md
@@ -5,16 +5,35 @@ describe + categorize each photo, and embeds the result as standard metadata
 inside the photo file so everything becomes searchable (Spotlight, Photos,
 Lightroom, etc.). Nothing is ever deleted, moved, or renamed.
 
-## Run it
+## Run it — zero config
+
+Drop this whole folder *inside* the photo collection you want to organize,
+then just run it:
 
 ```bash
-cd "/Users/drjones/photo ollama app organizer"
+cd "your-photo-library/photon"
 python3 server.py
 # then open http://localhost:8765
 ```
 
-Requires: Ollama running with a vision model, `exiftool` (installed via brew),
-macOS (`sips` is used for fast downscaling).
+It auto-detects the folder to scan as **the parent of wherever this app
+lives** — so if you dropped it into `~/Pictures/Vacation2026/photon`, it
+defaults to scanning `~/Pictures/Vacation2026`. The folder it last scanned is
+also remembered automatically (`photon_folder.json`), so on every future
+launch it just picks up where you left off — no retyping paths.
+
+Want to point it somewhere else? Any of these work, in priority order:
+```bash
+python3 server.py /path/to/photos        # one-off CLI override
+PHOTON_FOLDER=/path/to/photos python3 server.py   # env var override
+```
+Or just type a new path into the folder field in the Console tab and hit
+**Scan Directory** — that becomes the new remembered default too. Running
+two libraries at once? `PHOTON_PORT=8766 python3 server.py` avoids a port clash.
+
+Requires: Ollama running with a vision model, `exiftool` (installed via
+brew), macOS (`sips` for fast downscaling), and `ffmpeg`/`ffprobe` (for video
+thumbnails and tagging — optional, everything else works without it).
 
 ## How it works
 
@@ -63,5 +82,35 @@ Tested defaults: scout `glm-ocr` (6/6 routing accuracy) → describer
 ## Searching afterwards
 
 Spotlight: just type a word from a description in Finder search.
-Or from terminal: `mdfind -onlyin "/Volumes/sanD/allphotos from phone" "scooter"`
+Or from terminal: `mdfind -onlyin "/path/to/your/photos" "scooter"`
 Or grep the journal: `grep -i scooter photon_journal.jsonl`
+
+Or use the app itself — the **Search & Edit** tab is a full photo library browser:
+
+- **Tagged** — instant multi-word search across description/category/filename/path,
+  filter by category (click a chip), date range, or file type (photos/videos),
+  sort by newest/name/category. Click any result for a full-resolution
+  viewer + editor with Save / AI Redo / Reveal-in-Finder.
+- **Untagged** / **Failed** — see what's left to do or what errored, tag or
+  retry one at a time without leaving the grid.
+- **Videos** — thumbnails via `ffmpeg` frame-grab, native playback, AI tagging
+  off an extracted frame.
+- **Duplicates** — one-time background scan builds a perceptual-hash index and
+  groups exact visual matches (re-saves, burst duplicates). No auto-delete —
+  just Reveal-in-Finder per copy so you decide.
+
+**Selecting & downloading photos in bulk:** click **Select** to enter select
+mode, then:
+- click a photo to toggle it, **shift-click** to select a range
+- **Select all loaded** / **Select all N matching** (grabs everything matching
+  your current search, not just what's rendered) / **Clear selection**
+- **Download selected (ZIP)** or **Download all matches (ZIP)** — streams a
+  real zip of the original files, byte-for-byte, no re-compression (capped at
+  3000 files per zip)
+- **Apply category to selected**, or **Export** the set as CSV/JSON
+
+## Appearance
+
+Settings & Safety → **Appearance**: pick an accent color (native color
+picker), grid density (compact/comfortable/large), and results-per-page.
+Saved per-browser, doesn't touch anything on disk.
diff --git a/index.html b/index.html
index 525f2d6..d4760fa 100644
--- a/index.html
+++ b/index.html
@@ -7,13 +7,20 @@
 <link href="https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;500;600;800&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet">
 <style>
 :root{
+  color-scheme: dark;
   --bg:#03050a; --panel:#080d1a; --panel2:#0c1328; --line:#162447;
   --cyan:#22d3ee; --cyan-dim:#0891b2; --mag:#e879f9; --mag-dim:#c084fc;
   --grn:#4ade80; --grn-dim:#16a34a; --amber:#fbbf24; --red:#f87171;
   --txt:#d1e2ff; --dim:#627a9f;
   --font-sans:'Outfit', sans-serif;
   --font-mono:'JetBrains Mono', monospace;
+  --thumb-min:190px;
 }
+input[type=date]::-webkit-calendar-picker-indicator{filter:invert(.7) brightness(1.6)}
+::-webkit-scrollbar{width:8px;height:8px}
+::-webkit-scrollbar-track{background:var(--bg)}
+::-webkit-scrollbar-thumb{background:var(--line);border-radius:4px}
+::-webkit-scrollbar-thumb:hover{background:var(--cyan-dim)}
 *{box-sizing:border-box;margin:0;padding:0}
 body{
   background:var(--bg); color:var(--txt); font-family:var(--font-sans);
@@ -117,6 +124,11 @@ button:disabled{opacity:.3;cursor:not-allowed}
 .set select,.set input[type=number]{width:100%;background:var(--panel2);border:1px solid var(--line);
   color:var(--txt);font-family:var(--font-sans);font-size:12px;padding:8px 10px;border-radius:4px}
 .set select:focus,.set input:focus{outline:none;border-color:var(--cyan)}
+.accent-row{display:flex;align-items:center;gap:12px;margin-top:6px;flex-wrap:wrap}
+input[type=color]{width:46px;height:32px;border:1px solid var(--line);border-radius:4px;background:var(--panel2);cursor:pointer;padding:2px}
+.accent-swatches{display:flex;gap:7px}
+.accent-swatch{width:22px;height:22px;border-radius:50%;border:2px solid var(--line);cursor:pointer;flex-shrink:0}
+.accent-swatch:hover{border-color:#fff;transform:scale(1.1)}
 .seg{display:flex;gap:4px}
 .seg button{flex:1;padding:6px 2px;font-size:10px;letter-spacing:1px}
 .seg button.on{border-color:var(--cyan);color:var(--cyan);background:rgba(34,211,238,.08)}
@@ -139,29 +151,97 @@ button:disabled{opacity:.3;cursor:not-allowed}
 .pbar .glint{position:absolute;inset:0;background:repeating-linear-gradient(-45deg,transparent 0 8px,rgba(255,255,255,.04) 8px 16px)}
 .plabel{display:flex;justify-content:space-between;font-size:10px;color:var(--dim);letter-spacing:1px;margin-top:6px}
 
+/* ---------- library view tabs ---------- */
+.view-tabs{display:flex;gap:4px;padding:10px 12px 0;flex-wrap:wrap}
+.view-btn{background:transparent;border:1px solid var(--line);color:var(--dim);padding:6px 14px;font-size:10px;letter-spacing:1.5px;text-transform:uppercase;border-radius:4px 4px 0 0;cursor:pointer}
+.view-btn:hover{color:#fff}
+.view-btn.active{color:var(--cyan);background:var(--panel2);border-bottom-color:var(--panel2);box-shadow:0 -2px 8px rgba(34,211,238,.1)}
+.lib-view{display:none;border-top:1px solid var(--line)}
+.lib-view.active{display:block}
+
+/* ---------- category chips / saved searches ---------- */
+.cat-chip-row{display:flex;gap:6px;padding:10px 12px;flex-wrap:wrap;background:var(--panel2);border-bottom:1px solid var(--line)}
+.cat-chip{background:var(--panel);border:1px solid var(--line);color:var(--dim);font-size:9px;letter-spacing:1px;text-transform:uppercase;
+  padding:5px 10px;border-radius:12px;cursor:pointer;font-family:var(--font-sans);font-weight:600;white-space:nowrap}
+.cat-chip:hover{color:var(--txt);border-color:var(--cyan)}
+.cat-chip.on{color:var(--mag);border-color:var(--mag);background:rgba(232,121,249,.08)}
+.saved-search-row{display:flex;gap:6px;padding:8px 12px;flex-wrap:wrap;align-items:center;border-bottom:1px solid var(--line)}
+.saved-chip{display:flex;align-items:center;gap:6px;background:var(--panel);border:1px solid var(--line);color:var(--dim);
+  font-size:10px;padding:4px 6px 4px 10px;border-radius:12px;cursor:pointer}
+.saved-chip:hover{border-color:var(--cyan);color:var(--txt)}
+.saved-chip b{font-weight:400;cursor:pointer;color:var(--red);padding:2px 4px}
+.saved-chip b:hover{color:#fff}
+
+/* ---------- bulk selection ---------- */
+.bulk-bar{display:flex;gap:8px;align-items:center;flex-wrap:wrap;padding:10px 12px;background:rgba(34,211,238,.06);border-bottom:1px solid var(--line)}
+.bulk-bar select{background:var(--panel);border:1px solid var(--line);color:var(--txt);padding:7px 10px;border-radius:4px;font-size:11px}
+.result-card2{position:relative}
+.result-checkbox{position:absolute;top:6px;left:6px;width:18px;height:18px;border-radius:3px;border:2px solid rgba(255,255,255,.6);
+  background:rgba(3,5,10,.5);z-index:2;display:none}
+.result-checkbox.show{display:block}
+.result-checkbox.checked{background:var(--cyan);border-color:var(--cyan)}
+.result-card2.checked{outline:2px solid var(--cyan)}
+
+/* ---------- untagged / failed / videos card variants ---------- */
+.tag-now-btn{width:100%;margin-top:6px;padding:6px;font-size:9px}
+.video-badge{position:absolute;top:5px;right:5px;font-size:8px;background:rgba(3,5,10,.8);color:var(--cyan);padding:2px 5px;border-radius:3px;letter-spacing:1px}
+
+/* ---------- duplicate groups ---------- */
+.dupe-group{background:var(--panel2);border:1px solid var(--line);border-radius:6px;margin-bottom:12px;overflow:hidden}
+.dupe-group-header{padding:8px 12px;font-size:10px;letter-spacing:1px;text-transform:uppercase;color:var(--mag);background:rgba(232,121,249,.06);border-bottom:1px solid var(--line)}
+.dupe-thumb-row{display:flex;gap:10px;padding:10px;overflow-x:auto}
+.dupe-thumb{flex-shrink:0;width:130px;text-align:center}
+.dupe-thumb img{width:130px;height:130px;object-fit:cover;border-radius:4px;border:1px solid var(--line);background:#000;cursor:pointer}
+.dupe-thumb .name{font-size:9px;color:var(--dim);font-family:var(--font-mono);margin-top:4px;word-break:break-all}
+.dupe-thumb button{width:100%;margin-top:4px;padding:4px;font-size:8px}
+
 /* ---------- search interface ---------- */
-.search-grid{display:grid;grid-template-columns:1fr 400px;gap:14px;height:700px}
-@media(max-width:960px){.search-grid{grid-template-columns:1fr;height:auto}}
-.search-left{display:flex;flex-direction:column;height:100%}
-.search-bar-row{display:flex;gap:10px;padding:12px;background:var(--panel2);border-bottom:1px solid var(--line)}
-.search-bar-row input{flex:1;background:var(--panel);border:1px solid var(--line);color:var(--txt);padding:8px 12px;border-radius:4px;font-family:var(--font-sans)}
-.search-bar-row input:focus{outline:none;border-color:var(--cyan)}
-.search-results{flex:1;overflow-y:auto;padding:12px;display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:10px;align-content:start}
-.search-results::-webkit-scrollbar{width:6px}
-.search-results::-webkit-scrollbar-thumb{background:var(--line);border-radius:3px}
+.search-toolbar{display:flex;gap:10px;padding:12px;background:var(--panel2);border-bottom:1px solid var(--line);flex-wrap:wrap;align-items:center}
+.search-toolbar input[type=text]{flex:2;min-width:220px;background:var(--panel);border:1px solid var(--line);color:var(--txt);padding:9px 12px;border-radius:4px;font-family:var(--font-sans);font-size:13px}
+.search-toolbar input[type=text]:focus{outline:none;border-color:var(--cyan);box-shadow:0 0 10px rgba(34,211,238,.15)}
+.search-toolbar select{background:var(--panel);border:1px solid var(--line);color:var(--txt);padding:9px 10px;border-radius:4px;font-size:12px;font-family:var(--font-sans)}
+.search-toolbar select:focus{outline:none;border-color:var(--cyan)}
+.search-count{font-size:11px;color:var(--dim);letter-spacing:.5px;white-space:nowrap;margin-left:auto;font-family:var(--font-mono)}
 
-.result-card{background:var(--panel2);border:1px solid var(--line);border-radius:6px;overflow:hidden;display:flex;gap:10px;padding:8px;cursor:pointer;transition:.15s}
-.result-card:hover{border-color:var(--cyan);transform:translateY(-1px)}
-.result-card img{width:70px;height:70px;object-fit:cover;border-radius:4px;background:#000;flex-shrink:0}
-.result-info{display:flex;flex-direction:column;justify-content:space-between;overflow:hidden}
-.result-name{font-size:11px;color:var(--cyan);font-family:var(--font-mono);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-.result-desc{font-size:11px;color:var(--txt);line-height:1.4;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}
-.result-cat{font-size:9px;color:var(--mag);text-transform:uppercase;letter-spacing:1px;font-weight:600}
+.search-results-grid{padding:14px;display:grid;grid-template-columns:repeat(auto-fill,minmax(var(--thumb-min),1fr));gap:12px;align-content:start;min-height:200px}
+.search-empty{grid-column:1/-1;text-align:center;padding:60px 20px;color:var(--dim);text-transform:uppercase;letter-spacing:1px;font-size:11px}
 
-.editor-panel{display:flex;flex-direction:column;height:100%;padding:14px;background:var(--panel2);border-left:1px solid var(--line)}
-.editor-img{width:100%;aspect-ratio:1.5;background:#000;border:1px solid var(--line);border-radius:4px;display:flex;align-items:center;justify-content:center;overflow:hidden;margin-bottom:12px}
-.editor-img img{max-width:100%;max-height:100%;object-fit:contain}
-.editor-fields{flex:1;overflow-y:auto;display:flex;flex-direction:column;gap:10px}
+.result-card2{background:var(--panel2);border:1px solid var(--line);border-radius:6px;overflow:hidden;cursor:pointer;transition:.15s;display:flex;flex-direction:column}
+.result-card2:hover{border-color:var(--cyan);transform:translateY(-2px);box-shadow:0 6px 18px rgba(0,0,0,.35)}
+.result-thumb{position:relative;aspect-ratio:1;background:#000}
+.result-thumb img{width:100%;height:100%;object-fit:cover;display:block}
+.result-cat-badge{position:absolute;bottom:5px;left:5px;right:5px;font-size:8px;letter-spacing:1px;text-transform:uppercase;font-weight:700;
+  color:var(--mag);background:rgba(3,5,10,.78);border:1px solid rgba(232,121,249,.4);padding:3px 6px;border-radius:3px;
+  white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.result-body{padding:8px 9px 10px}
+.result-name{font-size:10px;color:var(--cyan);font-family:var(--font-mono);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;margin-bottom:4px}
+.result-desc2{font-size:11px;color:var(--txt);line-height:1.4;display:-webkit-box;-webkit-line-clamp:3;-webkit-box-orient:vertical;overflow:hidden}
+mark{background:rgba(34,211,238,.28);color:#fff;border-radius:2px;padding:0 1px}
+
+.load-more-row{display:flex;justify-content:center;padding:6px 14px 20px}
+
+/* ---------- fullscreen viewer / editor lightbox ---------- */
+.lightbox{position:fixed;inset:0;background:rgba(2,4,10,.97);z-index:1000;display:none;flex-direction:column;backdrop-filter:blur(2px)}
+.lightbox.active{display:flex}
+.lightbox-topbar{display:flex;justify-content:space-between;align-items:center;padding:10px 16px;border-bottom:1px solid var(--line);background:var(--panel);flex-shrink:0}
+.lightbox-pos{font-family:var(--font-mono);color:var(--dim);font-size:12px;letter-spacing:1px}
+.lightbox-topbar-actions{display:flex;gap:8px}
+.lightbox-body{flex:1;display:grid;grid-template-columns:1fr 380px;overflow:hidden;min-height:0}
+@media(max-width:900px){.lightbox-body{grid-template-columns:1fr;overflow-y:auto}}
+.lightbox-imgwrap{position:relative;display:flex;align-items:center;justify-content:center;background:#000;overflow:hidden;min-height:0}
+.lightbox-imgwrap img{max-width:100%;max-height:100%;object-fit:contain;display:none}
+.lightbox-loading{color:var(--dim);font-size:10px;letter-spacing:2px;text-transform:uppercase;position:absolute}
+.lightbox-nav-btn{position:absolute;top:50%;transform:translateY(-50%);background:rgba(8,13,26,.7);border:1px solid var(--line);color:var(--txt);
+  width:40px;height:56px;font-size:18px;cursor:pointer;border-radius:4px;transition:.15s}
+.lightbox-nav-btn:hover:not(:disabled){border-color:var(--cyan);color:var(--cyan)}
+.lightbox-nav-btn:disabled{opacity:.15;cursor:not-allowed}
+.lightbox-nav-btn.prev{left:12px}
+.lightbox-nav-btn.next{right:12px}
+.lightbox-sidebar{background:var(--panel2);border-left:1px solid var(--line);padding:16px;overflow-y:auto;display:flex;flex-direction:column}
+.lb-meta-grid{display:grid;grid-template-columns:1fr 1fr;gap:8px;font-size:11px;color:var(--dim);background:rgba(0,0,0,.15);padding:10px;border-radius:4px;margin-top:4px}
+.lb-meta-grid div b{color:var(--txt);display:block;font-weight:600;font-size:12px;font-family:var(--font-mono)}
+
+.editor-fields{flex:1;display:flex;flex-direction:column;gap:10px}
 .editor-fields label{font-size:9px;letter-spacing:1.5px;text-transform:uppercase;color:var(--dim);font-weight:600}
 .editor-fields textarea{background:var(--panel);border:1px solid var(--line);color:var(--txt);padding:8px 10px;border-radius:4px;font-family:var(--font-sans);font-size:12px;resize:none;height:100px}
 .editor-fields textarea:focus{outline:none;border-color:var(--cyan)}
@@ -251,7 +331,7 @@ button:disabled{opacity:.3;cursor:not-allowed}
   <div id="tab-console" class="tab-content active">
     <div class="controls">
       <div class="folderRow">
-        <input id="folder" spellcheck="false" value="/Volumes/sanD/allphotos from phone">
+        <input id="folder" spellcheck="false" placeholder="/path/to/your/photos">
         <button id="btnScan">◈ Scan Directory</button>
       </div>
       <button id="btnStart" class="btn-primary" disabled>▶ Start Pipeline</button>
@@ -323,47 +403,109 @@ button:disabled{opacity:.3;cursor:not-allowed}
   <!-- ==================== SEARCH & EDIT TAB ==================== -->
   <div id="tab-search" class="tab-content">
     <div class="panel">
-      <h2>⌕ <b>journal search & meta inspector</b></h2>
-      <div class="search-grid">
-        <div class="search-left">
-          <div class="search-bar-row">
-            <input id="searchInput" placeholder="Search by name, category, or description keywords..." spellcheck="false">
-            <button id="btnSearch" class="btn-primary">Search</button>
-            <button id="btnSyncMeta">⟳ Sync Metadata</button>
-          </div>
-          <div class="search-results" id="searchResults">
-            <div style="grid-column:1/-1; text-align:center; padding:50px; color:var(--dim); text-transform:uppercase; letter-spacing:1px">Type a search query or press Search to list all tagged photos.</div>
-          </div>
+      <h2>⌕ <b>photo library</b> — search, browse & bulk edit</h2>
+      <div class="view-tabs" id="viewTabs">
+        <button class="view-btn active" data-view="tagged">Tagged</button>
+        <button class="view-btn" data-view="untagged">Untagged</button>
+        <button class="view-btn" data-view="failed">Failed</button>
+        <button class="view-btn" data-view="videos">Videos</button>
+        <button class="view-btn" data-view="dupes">Duplicates</button>
+      </div>
+
+      <!-- TAGGED -->
+      <div id="view-tagged" class="lib-view active">
+        <div class="search-toolbar">
+          <input type="text" id="searchInput" placeholder="Search any word in the description, category, filename or path…" spellcheck="false">
+          <select id="searchCat"><option value="">All categories</option></select>
+          <select id="searchFtype">
+            <option value="">Photos & videos</option>
+            <option value="photo">Photos only</option>
+            <option value="video">Videos only</option>
+          </select>
+          <select id="searchSort">
+            <option value="recent">Newest tagged</option>
+            <option value="name">Filename A–Z</option>
+            <option value="category">Category</option>
+          </select>
+          <input type="date" id="dateFrom" title="From date">
+          <input type="date" id="dateTo" title="To date">
+          <button id="btnSyncMeta">⟳ Sync Metadata</button>
+          <button id="btnSelectMode" title="In select mode: click to toggle a photo, shift-click to select a range">☐ Select</button>
+          <span class="search-count" id="searchCount">—</span>
         </div>
-        <!-- Inspector / Editor -->
-        <div class="editor-panel">
-          <h3 style="font-size:11px; text-transform:uppercase; letter-spacing:1px; color:var(--dim); margin-bottom:12px; border-bottom:1px solid var(--line); padding-bottom:6px">photo inspector</h3>
-          <div class="editor-img">
-            <img id="editPreview" style="display:none">
-            <div id="editNoSignal" style="color:var(--dim); font-size:10px; letter-spacing:2px">SELECT A PHOTO</div>
-          </div>
-          <div class="editor-fields">
-            <label>File path</label>
-            <div class="editor-path" id="editPath">—</div>
-            
-            <label>category</label>
-            <select id="editCat"></select>
-            
-            <label>description</label>
-            <textarea id="editDesc" placeholder="Photo description..."></textarea>
-          </div>
-          <div class="editor-actions">
-            <button id="btnSaveSingle" class="btn-primary" disabled>✓ Save</button>
-            <button id="btnRedoSingle" disabled>⌁ AI Redo</button>
-            <button id="btnRevealSingle" style="grid-column:1/-1" disabled>Reveal in Finder</button>
-          </div>
+        <div class="cat-chip-row" id="catChipRow"></div>
+        <div class="saved-search-row" id="savedSearchRow">
+          <button id="btnSaveSearch">☆ Save current search</button>
         </div>
+        <div class="bulk-bar" id="bulkBar" style="display:none">
+          <span id="bulkCount">0 selected</span>
+          <button id="btnSelectLoaded">Select all loaded</button>
+          <button id="btnSelectAllMatching">Select all N matching</button>
+          <button id="btnClearSelection">Clear selection</button>
+          <select id="bulkCatSelect"></select>
+          <button id="btnBulkApply" class="btn-primary">Apply category to selected</button>
+          <button id="btnDownloadSelected" class="btn-primary">⬇ Download selected (ZIP)</button>
+          <button id="btnExportSelected">Export selected (JSON)</button>
+          <button id="btnExportAllCsv">Export all matches (CSV)</button>
+          <button id="btnDownloadAllZip">⬇ Download all matches (ZIP)</button>
+        </div>
+        <div class="search-results-grid" id="searchResultsGrid">
+          <div class="search-empty">Loading tagged photos…</div>
+        </div>
+        <div class="load-more-row">
+          <button id="btnLoadMore" style="display:none">Load more results ▾</button>
+        </div>
+      </div>
+
+      <!-- UNTAGGED -->
+      <div id="view-untagged" class="lib-view">
+        <div class="search-toolbar"><span class="search-count" id="untaggedCount">—</span></div>
+        <div class="search-results-grid" id="untaggedGrid"></div>
+        <div class="load-more-row"><button id="btnLoadMoreUntagged" style="display:none">Load more ▾</button></div>
+      </div>
+
+      <!-- FAILED -->
+      <div id="view-failed" class="lib-view">
+        <div class="search-toolbar">
+          <span class="search-count" id="failedCount">—</span>
+          <button id="btnRetryAllFailed" class="btn-primary">⟳ Retry all failed</button>
+        </div>
+        <div class="search-results-grid" id="failedGrid"></div>
+      </div>
+
+      <!-- VIDEOS -->
+      <div id="view-videos" class="lib-view">
+        <div class="search-toolbar"><span class="search-count" id="videosCount">—</span></div>
+        <div class="search-results-grid" id="videosGrid"></div>
+        <div class="load-more-row"><button id="btnLoadMoreVideos" style="display:none">Load more ▾</button></div>
+      </div>
+
+      <!-- DUPLICATES -->
+      <div id="view-dupes" class="lib-view">
+        <div class="search-toolbar">
+          <span class="search-count" id="dupesStatus">—</span>
+          <button id="btnScanDupes" class="btn-primary">⟳ Scan for duplicates</button>
+        </div>
+        <div id="dupesProgress" class="hint" style="padding:0 14px 10px; display:none"></div>
+        <div id="dupesGroups" style="padding:14px"></div>
       </div>
     </div>
   </div>
 
   <!-- ==================== BLIND AUDIT TAB ==================== -->
   <div id="tab-audit" class="tab-content">
+    <div class="panel" id="auditHistoryPanel" style="max-width:900px;margin:20px auto 0">
+      <h2>◷ <b>audit history</b> — accuracy over time</h2>
+      <div class="statsRow" style="padding:14px 14px 0">
+        <div class="stat"><div class="v" id="ahTotal">0</div><div class="k">total graded</div></div>
+        <div class="stat"><div class="v" id="ahAccuracy">—</div><div class="k">overall accuracy</div></div>
+        <div class="stat"><div class="v" id="ahPassed">0</div><div class="k">passed</div></div>
+        <div class="stat"><div class="v" id="ahFailed">0</div><div class="k">failed</div></div>
+      </div>
+      <div class="chart-container" style="margin:14px">
+        <div class="bar-chart" id="ahDayChart"></div>
+      </div>
+    </div>
     <div class="audit-container">
       <!-- Start View -->
       <div class="audit-start-card" id="auditStartCard">
@@ -433,6 +575,32 @@ button:disabled{opacity:.3;cursor:not-allowed}
 
   <!-- ==================== SETTINGS & SAFETY TAB ==================== -->
   <div id="tab-settings" class="tab-content">
+    <!-- Appearance -->
+    <div class="panel">
+      <h2>◐ <b>appearance</b> — accent color & browsing preferences</h2>
+      <div class="set">
+        <label>accent color</label>
+        <div class="accent-row">
+          <input type="color" id="accentColor" value="#22d3ee">
+          <div class="accent-swatches" id="accentSwatches"></div>
+        </div>
+        <div class="hint">picks the highlight color used across borders, buttons and badges. saved locally on this browser.</div>
+
+        <label>photo grid density</label>
+        <div class="seg" id="segDensity">
+          <button data-v="150">compact</button>
+          <button data-v="190" class="on">comfortable</button>
+          <button data-v="260">large</button>
+        </div>
+
+        <label>search results per page</label>
+        <div class="seg" id="segPageSize">
+          <button data-v="30">30</button>
+          <button data-v="60" class="on">60</button>
+          <button data-v="100">100</button>
+        </div>
+      </div>
+    </div>
     <div class="grid">
       <!-- Engine Options -->
       <div class="panel">
@@ -541,9 +709,50 @@ button:disabled{opacity:.3;cursor:not-allowed}
   </div>
 </div>
 
+<!-- ==================== FULLSCREEN VIEWER / EDITOR ==================== -->
+<div class="lightbox" id="lightbox">
+  <div class="lightbox-topbar">
+    <div class="lightbox-pos" id="lbPos">1 / 1</div>
+    <div class="lightbox-topbar-actions">
+      <button id="lbReveal">Reveal in Finder</button>
+      <button id="lbClose" class="btn-danger">✕ Close</button>
+    </div>
+  </div>
+  <div class="lightbox-body">
+    <div class="lightbox-imgwrap">
+      <button class="lightbox-nav-btn prev" id="lbPrev">‹</button>
+      <img id="lbImg" alt="">
+      <video id="lbVideo" controls style="max-width:100%;max-height:100%;display:none"></video>
+      <div class="lightbox-loading" id="lbLoading">loading full image…</div>
+      <button class="lightbox-nav-btn next" id="lbNext">›</button>
+    </div>
+    <div class="lightbox-sidebar">
+      <h3 style="font-size:11px; text-transform:uppercase; letter-spacing:1px; color:var(--dim); margin-bottom:12px; border-bottom:1px solid var(--line); padding-bottom:6px">photo inspector</h3>
+      <div class="editor-fields">
+        <label>file path</label>
+        <div class="editor-path" id="lbPath">—</div>
+        <button id="lbCopyPath" style="margin-top:6px">⧉ Copy path</button>
+
+        <label>category</label>
+        <select id="lbCat"></select>
+
+        <label>description</label>
+        <textarea id="lbDesc" placeholder="Photo description..."></textarea>
+
+        <label>tag details</label>
+        <div class="lb-meta-grid" id="lbMeta"></div>
+      </div>
+      <div class="editor-actions">
+        <button id="lbSave" class="btn-primary">✓ Save</button>
+        <button id="lbRedo">⌁ AI Redo</button>
+      </div>
+    </div>
+  </div>
+</div>
+
 <script>
 const $=id=>document.getElementById(id);
-let CATS=[], state="idle", scanned=false, currentEditFile=null;
+let CATS=[], state="idle", scanned=false;
 let recentFiles=[];
 
 /* ---------- Tab Management ---------- */
@@ -552,7 +761,8 @@ function showTab(tabId){
   document.querySelectorAll(".tab-btn").forEach(el=>el.classList.remove("active"));
   $("tab-"+tabId).classList.add("active");
   $("btn-tab-"+tabId).classList.add("active");
-  if(tabId==='search') doSearch();
+  if(tabId==='search') switchView(currentView);
+  if(tabId==='audit') loadAuditHistory();
 }
 
 /* ---------- helpers ---------- */
@@ -566,10 +776,79 @@ document.querySelectorAll(".sw").forEach(s=>s.onclick=()=>{
 const segVal=el=>el.querySelector("button.on").dataset.v;
 const swOn=id=>$(id).classList.contains("on");
 
+/* ---------- appearance settings (accent color, density, page size) ---------- */
+const ACCENT_PRESETS = ["#22d3ee","#e879f9","#4ade80","#fbbf24","#f87171","#818cf8","#fb923c"];
+
+function hexToRgb(hex){
+  const m = hex.replace("#","");
+  return [parseInt(m.slice(0,2),16), parseInt(m.slice(2,4),16), parseInt(m.slice(4,6),16)];
+}
+function shade(hex, factor){
+  const [r,g,b] = hexToRgb(hex).map(v=>Math.max(0, Math.min(255, Math.round(v*factor))));
+  return "#" + [r,g,b].map(v=>v.toString(16).padStart(2,"0")).join("");
+}
+function applyAccentColor(hex, persist){
+  document.documentElement.style.setProperty("--cyan", hex);
+  document.documentElement.style.setProperty("--cyan-dim", shade(hex, 0.65));
+  $("accentColor").value = hex;
+  if(persist !== false) localStorage.setItem("photonAccentColor", hex);
+}
+function renderAccentSwatches(){
+  const row = $("accentSwatches");
+  row.innerHTML = "";
+  ACCENT_PRESETS.forEach(c=>{
+    const sw = document.createElement("div");
+    sw.className = "accent-swatch";
+    sw.style.background = c;
+    sw.title = c;
+    sw.onclick = ()=>applyAccentColor(c);
+    row.appendChild(sw);
+  });
+}
+$("accentColor").oninput = (e)=>applyAccentColor(e.target.value);
+
+seg($("segDensity"));
+$("segDensity").querySelectorAll("button").forEach(b=>b.addEventListener("click", ()=>{
+  const px = b.dataset.v + "px";
+  document.documentElement.style.setProperty("--thumb-min", px);
+  localStorage.setItem("photonGridDensity", b.dataset.v);
+}));
+
+seg($("segPageSize"));
+$("segPageSize").querySelectorAll("button").forEach(b=>b.addEventListener("click", ()=>{
+  SEARCH_LIMIT = parseInt(b.dataset.v, 10);
+  localStorage.setItem("photonPageSize", b.dataset.v);
+}));
+
+function loadAppearanceSettings(){
+  renderAccentSwatches();
+  const savedColor = localStorage.getItem("photonAccentColor");
+  if(savedColor) applyAccentColor(savedColor, false);
+
+  const savedDensity = localStorage.getItem("photonGridDensity");
+  if(savedDensity){
+    document.documentElement.style.setProperty("--thumb-min", savedDensity + "px");
+    $("segDensity").querySelectorAll("button").forEach(b=>b.classList.toggle("on", b.dataset.v === savedDensity));
+  }
+
+  const savedPageSize = localStorage.getItem("photonPageSize");
+  if(savedPageSize){
+    SEARCH_LIMIT = parseInt(savedPageSize, 10);
+    $("segPageSize").querySelectorAll("button").forEach(b=>b.classList.toggle("on", b.dataset.v === savedPageSize));
+  }
+}
+
 function fmtEta(s){ if(s==null)return "—";
   if(s<3600)return Math.floor(s/60)+"m "+(s%60)+"s";
   const h=Math.floor(s/3600); return h+"h "+Math.floor((s%3600)/60)+"m"; }
 
+function fmtBytes(n){
+  if(n == null) return "—";
+  if(n < 1024) return n + " B";
+  if(n < 1024*1024) return (n/1024).toFixed(1) + " KB";
+  return (n/(1024*1024)).toFixed(1) + " MB";
+}
+
 function addLog(e){
   const t=$("term");
   const d=document.createElement("div");
@@ -620,6 +899,8 @@ function renderCats(counts){
                   <div class="bar-val">${cnt}</div>`;
     densityBox.appendChild(br);
   });
+  lastCatCounts = counts;
+  renderCatChips();
 }
 
 function applyStats(s){
@@ -660,7 +941,7 @@ function renderRecentStrip(){
     item.className = "recent-item";
     item.onclick = () => {
       showTab("search");
-      inspectPhoto(photo);
+      openQuickView(photo);
     };
     item.innerHTML = `<img src="/api/thumbnail?path=${encodeURIComponent(photo.path)}">
                       <div class="cat-badge">${photo.category}</div>`;
@@ -766,131 +1047,674 @@ $("btnSaveCats").onclick = async ()=>{
 };
 
 function populateCategoryDropdowns(){
-  const editCat = $("editCat");
-  editCat.innerHTML = "";
+  const lbCat = $("lbCat");
+  lbCat.innerHTML = "";
   CATS.forEach(c=>{
     const opt = document.createElement("option");
     opt.value = c; opt.textContent = c;
-    editCat.appendChild(opt);
+    lbCat.appendChild(opt);
+  });
+
+  const searchCat = $("searchCat");
+  const prevVal = searchCat.value;
+  searchCat.innerHTML = '<option value="">All categories</option>';
+  CATS.forEach(c=>{
+    const opt = document.createElement("option");
+    opt.value = c; opt.textContent = c;
+    searchCat.appendChild(opt);
+  });
+  if([...searchCat.options].some(o=>o.value === prevVal)) searchCat.value = prevVal;
+
+  const bulkCat = $("bulkCatSelect");
+  bulkCat.innerHTML = '<option value="">Choose category…</option>';
+  CATS.forEach(c=>{
+    const opt = document.createElement("option");
+    opt.value = c; opt.textContent = c;
+    bulkCat.appendChild(opt);
   });
 }
 
-/* ---------- Search and Inspector ---------- */
-async function doSearch(){
-  const q = $("searchInput").value;
-  const results = $("searchResults");
-  results.innerHTML = `<div style="grid-column:1/-1; text-align:center; padding:30px; color:var(--dim)">Searching...</div>`;
-  const j = await api("/api/search?q=" + encodeURIComponent(q));
-  if(j.results){
-    renderSearchResults(j.results);
-  }
+/* ---------- Search ---------- */
+let searchResults = [];   // currently loaded page(s) for the main grid
+let searchTotal = 0;
+let searchLoading = false;
+let searchDebounce = null;
+
+function engineSettings(){
+  return {
+    model: $("model").value,
+    router: swOn("swRouter"),
+    routerModel: $("routerModel").value,
+    shotModel: $("shotModel").value,
+    photoModel: $("photoModel").value,
+    ocrText: swOn("swOcr"),
+    ocrModel: "glm-ocr:latest",
+    maxPx: +segVal($("segPx")),
+    length: segVal($("segLen")),
+    temperature: +$("temperature").value,
+    keepAlive: $("keepAlive").value,
+    keepBackup: swOn("swBackup"),
+    preserveDate: swOn("swDate"),
+    organize: swOn("swOrganize")
+  };
 }
 
-$("btnSearch").onclick = doSearch;
-$("searchInput").onkeydown = e => { if(e.key === "Enter") doSearch(); };
+let SEARCH_LIMIT = 60;
+
+async function doSearch(reset){
+  if(reset === undefined) reset = true;
+  if(searchLoading) return;
+  if(reset) searchResults = [];
+  searchLoading = true;
+  if(reset){
+    $("searchResultsGrid").innerHTML = `<div class="search-empty">Searching…</div>`;
+    $("btnLoadMore").style.display = "none";
+  }
+  const params = currentSearchParams({limit: SEARCH_LIMIT, offset: reset ? 0 : searchResults.length});
+  const j = await api("/api/search?" + params.toString());
+  searchLoading = false;
+  if(!j.results) return;
+  searchResults.push(...j.results);
+  searchTotal = j.total || 0;
+  renderCatChips();
+  renderSearchResults();
+}
+
+$("searchInput").oninput = ()=>{
+  clearTimeout(searchDebounce);
+  searchDebounce = setTimeout(()=>doSearch(true), 280);
+};
+$("searchInput").onkeydown = e => { if(e.key === "Enter"){ clearTimeout(searchDebounce); doSearch(true); } };
+$("searchCat").onchange = ()=>{ renderCatChips(); doSearch(true); };
+$("searchSort").onchange = ()=>doSearch(true);
+$("btnLoadMore").onclick = ()=>doSearch(false);
 
 $("btnSyncMeta").onclick = async ()=>{
   if(confirm("Re-read all embedded metadata in directory? This will update your journal file with any manually updated photos.")){
     $("btnSyncMeta").disabled = true;
-    const j = await api("/api/search?re_read=1&q=" + encodeURIComponent($("searchInput").value));
+    const params = currentSearchParams({re_read:"1", limit: SEARCH_LIMIT});
+    const j = await api("/api/search?" + params.toString());
     $("btnSyncMeta").disabled = false;
-    if(j.results) renderSearchResults(j.results);
+    if(j.results){ searchResults = j.results; searchTotal = j.total || 0; renderSearchResults(); }
   }
 };
 
-function renderSearchResults(recs){
-  const box = $("searchResults");
-  box.innerHTML = "";
-  if(recs.length === 0){
-    box.innerHTML = `<div style="grid-column:1/-1; text-align:center; padding:50px; color:var(--dim)">No results found matching your query.</div>`;
+function highlightTerms(text, terms){
+  let out = escapeHtml(text || "");
+  terms.forEach(t=>{
+    if(!t) return;
+    const re = new RegExp("(" + t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&") + ")", "ig");
+    out = out.replace(re, "<mark>$1</mark>");
+  });
+  return out;
+}
+
+function renderSearchResults(){
+  const grid = $("searchResultsGrid");
+  $("searchCount").textContent = searchTotal + (searchTotal === 1 ? " match" : " matches");
+  if(searchResults.length === 0){
+    grid.innerHTML = `<div class="search-empty">No results found matching your query.</div>`;
+    $("btnLoadMore").style.display = "none";
     return;
   }
-  recs.forEach(rec=>{
+  const terms = $("searchInput").value.trim().split(/\s+/).filter(Boolean);
+  grid.innerHTML = "";
+  searchResults.forEach((rec, i)=>{
+    const checked = selectedPaths.has(rec.path);
     const card = document.createElement("div");
-    card.className = "result-card";
-    card.onclick = () => inspectPhoto(rec);
-    card.innerHTML = `<img src="/api/thumbnail?path=${encodeURIComponent(rec.path)}">
-                      <div class="result-info">
-                        <div class="result-name" title="${rec.name}">${rec.name}</div>
-                        <div class="result-desc" title="${rec.desc}">${rec.desc}</div>
-                        <div class="result-cat">${rec.category}</div>
-                      </div>`;
-    box.appendChild(card);
-  });
-}
-
-function inspectPhoto(rec){
-  currentEditFile = rec.path;
-  $("editPreview").src = "/api/thumbnail?path=" + encodeURIComponent(rec.path);
-  $("editPreview").style.display = "block";
-  $("editNoSignal").style.display = "none";
-  $("editPath").textContent = rec.path;
-  $("editDesc").value = rec.desc;
-  $("editCat").value = rec.category;
-  
-  $("btnSaveSingle").disabled = false;
-  $("btnRedoSingle").disabled = false;
-  $("btnRevealSingle").disabled = false;
-}
-
-$("btnSaveSingle").onclick = async ()=>{
-  if(!currentEditFile) return;
-  $("btnSaveSingle").disabled = true;
-  const j = await api("/api/write_single", {
-    path: currentEditFile,
-    desc: $("editDesc").value,
-    category: $("editCat").value
-  });
-  $("btnSaveSingle").disabled = false;
-  if(j.ok){
-    addLog({level:"ok",msg:`Updated ${os_basename(currentEditFile)} metadata manually.`,ts:new Date().toTimeString().slice(0,8)});
-    // Refresh search results
-    doSearch();
-  }
-};
-
-$("btnRedoSingle").onclick = async ()=>{
-  if(!currentEditFile) return;
-  if(confirm("Request AI model re-tagging for this photo?")){
-    $("btnRedoSingle").disabled = true;
-    const j = await api("/api/redo_single", {
-      path: currentEditFile,
-      settings: {
-        model: $("model").value,
-        router: swOn("swRouter"),
-        routerModel: $("routerModel").value,
-        shotModel: $("shotModel").value,
-        photoModel: $("photoModel").value,
-        ocrText: swOn("swOcr"),
-        ocrModel: "glm-ocr:latest",
-        maxPx: +segVal($("segPx")),
-        length: segVal($("segLen")),
-        temperature: +$("temperature").value,
-        keepAlive: $("keepAlive").value,
-        keepBackup: swOn("swBackup"),
-        preserveDate: swOn("swDate"),
-        organize: swOn("swOrganize")
+    card.className = "result-card2" + (checked ? " checked" : "");
+    card.onclick = (e) => {
+      if(selectMode){
+        if(e.shiftKey && lastClickedIndex !== null){ selectRange(lastClickedIndex, i); }
+        else { toggleSelect(rec.path); }
+        lastClickedIndex = i;
+        return;
       }
-    });
-    $("btnRedoSingle").disabled = false;
-    if(j.ok){
-      $("editDesc").value = j.desc;
-      $("editCat").value = j.category;
-      addLog({level:"ok",msg:`AI Re-evaluated ${os_basename(currentEditFile)} successfully.`,ts:new Date().toTimeString().slice(0,8)});
-      doSearch();
-    }
-  }
-};
-
-$("btnRevealSingle").onclick = async ()=>{
-  if(!currentEditFile) return;
-  api("/api/reveal", {path: currentEditFile});
-};
+      openLightbox(i);
+    };
+    card.innerHTML = `<div class="result-thumb">
+                        <div class="result-checkbox ${selectMode ? 'show' : ''} ${checked ? 'checked' : ''}"></div>
+                        <img loading="lazy" src="/api/thumbnail?path=${encodeURIComponent(rec.path)}">
+                        <span class="result-cat-badge">${escapeHtml(rec.category || "—")}</span>
+                       </div>
+                       <div class="result-body">
+                        <div class="result-name" title="${rec.name}">${escapeHtml(rec.name || "")}</div>
+                        <div class="result-desc2">${highlightTerms(rec.desc, terms)}</div>
+                       </div>`;
+    grid.appendChild(card);
+  });
+  $("btnLoadMore").style.display = searchResults.length < searchTotal ? "block" : "none";
+  if(selectMode) updateBulkBar();
+}
 
 function os_basename(path){
   return path.replace(/\\/g, '/').replace(/.*\//, '');
 }
 
+/* ---------- Fullscreen viewer / editor ---------- */
+let lbMode = "grid";   // "grid" | "quick"
+let lbIndex = -1;
+let lbQuickRec = null;
+
+function openLightbox(i){
+  lbMode = "grid";
+  lbIndex = i;
+  $("lightbox").classList.add("active");
+  renderLightbox();
+}
+
+function openQuickView(rec){
+  lbMode = "quick";
+  lbQuickRec = rec;
+  $("lightbox").classList.add("active");
+  renderLightbox();
+}
+
+function closeLightbox(){
+  $("lightbox").classList.remove("active");
+  $("lbVideo").pause();
+  lbIndex = -1;
+  lbQuickRec = null;
+}
+
+function currentLbRec(){
+  return lbMode === "quick" ? lbQuickRec : searchResults[lbIndex];
+}
+
+function renderLightbox(){
+  const rec = currentLbRec();
+  if(!rec) return;
+
+  if(lbMode === "quick"){
+    $("lbPos").textContent = "quick view";
+    $("lbPrev").style.display = "none";
+    $("lbNext").style.display = "none";
+  } else {
+    $("lbPos").textContent = (lbIndex+1) + " / " + (searchTotal || searchResults.length);
+    $("lbPrev").style.display = "";
+    $("lbNext").style.display = "";
+    $("lbPrev").disabled = lbIndex <= 0;
+    $("lbNext").disabled = false;
+  }
+
+  $("lbPath").textContent = rec.path;
+  $("lbDesc").value = rec.desc || "";
+  if([...$("lbCat").options].some(o=>o.value === rec.category)) $("lbCat").value = rec.category;
+  $("lbMeta").innerHTML = `
+    <div><b>${escapeHtml(rec.model || "—")}</b>model</div>
+    <div><b>${escapeHtml(rec.route || "—")}</b>route</div>
+    <div><b>${rec.ts ? new Date(rec.ts*1000).toLocaleString() : "—"}</b>tagged</div>
+    <div><b>${rec.sec != null ? rec.sec+"s" : "—"}</b>infer time</div>
+    <div><b>${fmtBytes(rec.sizeBytes)}</b>file size</div>`;
+
+  const img = $("lbImg");
+  const vid = $("lbVideo");
+  vid.pause(); vid.src = "";
+  if(VIDEO_EXT_RE.test(rec.path)){
+    img.style.display = "none";
+    $("lbLoading").style.display = "none";
+    vid.style.display = "block";
+    vid.src = "/api/photo?path=" + encodeURIComponent(rec.path);
+  } else {
+    vid.style.display = "none";
+    img.style.display = "none";
+    $("lbLoading").style.display = "block";
+    $("lbLoading").textContent = "loading full image…";
+    img.onload = ()=>{ img.style.display = "block"; $("lbLoading").style.display = "none"; };
+    img.onerror = ()=>{ $("lbLoading").textContent = "failed to load full image"; };
+    img.src = "/api/photo?path=" + encodeURIComponent(rec.path) + "&_=" + Date.now();
+  }
+}
+
+async function lbGoto(delta){
+  if(lbMode !== "grid") return;
+  const next = lbIndex + delta;
+  if(next < 0) return;
+  if(next >= searchResults.length){
+    if(searchResults.length < searchTotal){
+      await doSearch(false);
+      if(next >= searchResults.length) return;
+    } else return;
+  }
+  lbIndex = next;
+  renderLightbox();
+}
+
+$("lbPrev").onclick = ()=>lbGoto(-1);
+$("lbNext").onclick = ()=>lbGoto(1);
+$("lbClose").onclick = closeLightbox;
+
+document.addEventListener("keydown", e=>{
+  if(!$("lightbox").classList.contains("active")) return;
+  if(e.key === "Escape") closeLightbox();
+  else if(e.key === "ArrowLeft") lbGoto(-1);
+  else if(e.key === "ArrowRight") lbGoto(1);
+});
+
+$("lbSave").onclick = async ()=>{
+  const rec = currentLbRec();
+  if(!rec) return;
+  $("lbSave").disabled = true;
+  const j = await api("/api/write_single", { path: rec.path, desc: $("lbDesc").value, category: $("lbCat").value });
+  $("lbSave").disabled = false;
+  if(j.ok){
+    rec.desc = j.desc; rec.category = j.category;
+    if(lbMode === "grid") renderSearchResults();
+    addLog({level:"ok", msg:`Updated ${os_basename(rec.path)} metadata manually.`, ts:new Date().toTimeString().slice(0,8)});
+  }
+};
+
+$("lbRedo").onclick = async ()=>{
+  const rec = currentLbRec();
+  if(!rec) return;
+  if(!confirm("Request AI model re-tagging for this photo?")) return;
+  $("lbRedo").disabled = true;
+  const j = await api("/api/redo_single", { path: rec.path, settings: engineSettings() });
+  $("lbRedo").disabled = false;
+  if(j.ok){
+    rec.desc = j.desc; rec.category = j.category; rec.route = j.route;
+    renderLightbox();
+    if(lbMode === "grid") renderSearchResults();
+    addLog({level:"ok", msg:`AI re-evaluated ${os_basename(rec.path)} successfully.`, ts:new Date().toTimeString().slice(0,8)});
+  }
+};
+
+$("lbReveal").onclick = ()=>{
+  const rec = currentLbRec();
+  if(rec) api("/api/reveal", {path: rec.path});
+};
+
+$("lbCopyPath").onclick = async ()=>{
+  const rec = currentLbRec();
+  if(!rec) return;
+  try{
+    await navigator.clipboard.writeText(rec.path);
+    const btn = $("lbCopyPath");
+    const orig = btn.textContent;
+    btn.textContent = "✓ Copied";
+    setTimeout(()=>{ btn.textContent = orig; }, 1200);
+  }catch(e){
+    prompt("Copy path:", rec.path);
+  }
+};
+
+/* ================== Library sub-views (Tagged/Untagged/Failed/Videos/Duplicates) ================== */
+let currentView = "tagged";
+let lastCatCounts = {};
+const VIDEO_EXT_RE = /\.(mov|mp4|m4v|avi|3gp|mkv)$/i;
+
+function switchView(view){
+  currentView = view;
+  document.querySelectorAll(".view-btn").forEach(b=>b.classList.toggle("active", b.dataset.view === view));
+  document.querySelectorAll(".lib-view").forEach(el=>el.classList.remove("active"));
+  $("view-"+view).classList.add("active");
+  if(view === "tagged") doSearch(true);
+  else if(view === "untagged") loadUntagged(true);
+  else if(view === "failed") loadFailed();
+  else if(view === "videos") loadVideos(true);
+  else if(view === "dupes") loadDupeGroups();
+}
+document.querySelectorAll(".view-btn").forEach(b=>b.onclick = ()=>switchView(b.dataset.view));
+
+/* ---- category quick-filter chips ---- */
+function renderCatChips(){
+  const row = $("catChipRow");
+  if(!row) return;
+  row.innerHTML = "";
+  const activeCat = $("searchCat").value;
+  CATS.forEach(c=>{
+    const chip = document.createElement("button");
+    chip.className = "cat-chip" + (activeCat === c ? " on" : "");
+    chip.textContent = c + " (" + (lastCatCounts[c] ?? 0) + ")";
+    chip.onclick = ()=>{
+      $("searchCat").value = (activeCat === c) ? "" : c;
+      renderCatChips();
+      doSearch(true);
+    };
+    row.appendChild(chip);
+  });
+}
+
+/* ---- date range wiring ---- */
+$("dateFrom").onchange = ()=>doSearch(true);
+$("dateTo").onchange = ()=>doSearch(true);
+
+function currentSearchParams(extra){
+  return new URLSearchParams(Object.assign({
+    q: $("searchInput").value,
+    cat: $("searchCat").value,
+    sort: $("searchSort").value,
+    ftype: $("searchFtype").value,
+    date_from: $("dateFrom").value,
+    date_to: $("dateTo").value
+  }, extra || {}));
+}
+$("searchFtype").onchange = ()=>doSearch(true);
+
+/* ---- saved searches (client-side, localStorage) ---- */
+function loadSavedSearches(){
+  try{ return JSON.parse(localStorage.getItem("photonSavedSearches") || "[]"); }
+  catch(e){ return []; }
+}
+function storeSavedSearches(list){
+  localStorage.setItem("photonSavedSearches", JSON.stringify(list));
+}
+function renderSavedSearches(){
+  const row = $("savedSearchRow");
+  const saved = loadSavedSearches();
+  row.querySelectorAll(".saved-chip").forEach(el=>el.remove());
+  saved.forEach((s, i)=>{
+    const chip = document.createElement("div");
+    chip.className = "saved-chip";
+    chip.innerHTML = `<span>★ ${escapeHtml(s.name)}</span><b title="remove">✕</b>`;
+    chip.querySelector("span").onclick = ()=>{
+      $("searchInput").value = s.q || "";
+      $("searchCat").value = s.cat || "";
+      $("searchSort").value = s.sort || "recent";
+      $("dateFrom").value = s.date_from || "";
+      $("dateTo").value = s.date_to || "";
+      renderCatChips();
+      doSearch(true);
+    };
+    chip.querySelector("b").onclick = (e)=>{
+      e.stopPropagation();
+      const list = loadSavedSearches();
+      list.splice(i, 1);
+      storeSavedSearches(list);
+      renderSavedSearches();
+    };
+    row.appendChild(chip);
+  });
+}
+$("btnSaveSearch").onclick = ()=>{
+  const name = prompt("Name this search:", $("searchInput").value || "Untitled search");
+  if(!name) return;
+  const list = loadSavedSearches();
+  list.push({name, q: $("searchInput").value, cat: $("searchCat").value, sort: $("searchSort").value,
+             date_from: $("dateFrom").value, date_to: $("dateTo").value});
+  storeSavedSearches(list);
+  renderSavedSearches();
+};
+
+/* ---- bulk select mode ---- */
+let selectMode = false;
+let selectedPaths = new Set();
+let lastClickedIndex = null;
+
+$("btnSelectMode").onclick = ()=>{
+  selectMode = !selectMode;
+  $("btnSelectMode").textContent = selectMode ? "☑ Exit Select" : "☐ Select";
+  if(!selectMode){ selectedPaths.clear(); lastClickedIndex = null; }
+  renderSearchResults();
+  updateBulkBar();
+};
+
+function updateBulkBar(){
+  $("bulkBar").style.display = selectMode ? "flex" : "none";
+  $("bulkCount").textContent = selectedPaths.size + " selected";
+  $("btnSelectAllMatching").textContent = "Select all " + (searchTotal || 0) + " matching";
+}
+
+function toggleSelect(path){
+  if(selectedPaths.has(path)) selectedPaths.delete(path);
+  else selectedPaths.add(path);
+  renderSearchResults();
+  updateBulkBar();
+}
+
+function selectRange(fromIdx, toIdx){
+  const [lo, hi] = fromIdx <= toIdx ? [fromIdx, toIdx] : [toIdx, fromIdx];
+  for(let i = lo; i <= hi; i++){
+    if(searchResults[i]) selectedPaths.add(searchResults[i].path);
+  }
+  renderSearchResults();
+  updateBulkBar();
+}
+
+$("btnSelectLoaded").onclick = ()=>{
+  searchResults.forEach(r=>selectedPaths.add(r.path));
+  renderSearchResults();
+  updateBulkBar();
+};
+
+$("btnSelectAllMatching").onclick = async ()=>{
+  const params = currentSearchParams({});
+  const j = await api("/api/search/paths?" + params.toString());
+  if(!j.paths) return;
+  j.paths.forEach(p=>selectedPaths.add(p));
+  if(j.capped) addLog({level:"warn", msg:`Selected the first ${j.paths.length} of ${j.total} matches (download cap is 3000 files).`, ts:new Date().toTimeString().slice(0,8)});
+  renderSearchResults();
+  updateBulkBar();
+};
+
+$("btnClearSelection").onclick = ()=>{
+  selectedPaths.clear();
+  lastClickedIndex = null;
+  renderSearchResults();
+  updateBulkBar();
+};
+
+$("btnBulkApply").onclick = async ()=>{
+  const category = $("bulkCatSelect").value;
+  if(!category || selectedPaths.size === 0) return;
+  if(!confirm(`Recategorize ${selectedPaths.size} photos to "${category}"?`)) return;
+  $("btnBulkApply").disabled = true;
+  const j = await api("/api/bulk_recategorize", {paths: [...selectedPaths], category});
+  $("btnBulkApply").disabled = false;
+  if(j.ok){
+    addLog({level:"ok", msg:`Bulk recategorized ${j.updated} photos to '${category}'.`, ts:new Date().toTimeString().slice(0,8)});
+    selectedPaths.clear();
+    updateBulkBar();
+    doSearch(true);
+  }
+};
+
+$("btnExportSelected").onclick = ()=>{
+  if(selectedPaths.size === 0) return;
+  const params = currentSearchParams({format:"json", paths:[...selectedPaths].join(",")});
+  window.open("/api/export?" + params.toString(), "_blank");
+};
+$("btnExportAllCsv").onclick = ()=>{
+  const params = currentSearchParams({format:"csv"});
+  window.open("/api/export?" + params.toString(), "_blank");
+};
+
+$("btnDownloadSelected").onclick = ()=>{
+  if(selectedPaths.size === 0) return;
+  if(!confirm(`Download ${selectedPaths.size} photos as a ZIP, in their original quality?`)) return;
+  const params = new URLSearchParams({paths: [...selectedPaths].join(",")});
+  window.location.href = "/api/download_zip?" + params.toString();
+};
+$("btnDownloadAllZip").onclick = ()=>{
+  if(!confirm(`Download all ${searchTotal} matching photos as a ZIP, in their original quality? Large sets can take a while.`)) return;
+  const params = currentSearchParams({});
+  window.location.href = "/api/download_zip?" + params.toString();
+};
+
+/* ---- untagged view ---- */
+let untaggedItems = [], untaggedTotal = 0, untaggedLoading = false;
+async function loadUntagged(reset){
+  if(untaggedLoading) return;
+  if(reset) untaggedItems = [];
+  untaggedLoading = true;
+  const j = await api("/api/untagged?limit=48&offset=" + untaggedItems.length);
+  untaggedLoading = false;
+  if(!j.results) return;
+  untaggedItems.push(...j.results);
+  untaggedTotal = j.total || 0;
+  $("untaggedCount").textContent = untaggedTotal + " untagged photo" + (untaggedTotal===1?"":"s") +
+    (untaggedTotal ? " (scan the folder in Console to refresh this list)" : "");
+  const grid = $("untaggedGrid");
+  grid.innerHTML = untaggedItems.length ? "" : `<div class="search-empty">Nothing untagged — scan a folder from the Console tab, or everything's already tagged.</div>`;
+  untaggedItems.forEach(rec=>{
+    const card = document.createElement("div");
+    card.className = "result-card2";
+    card.innerHTML = `<div class="result-thumb"><img loading="lazy" src="/api/thumbnail?path=${encodeURIComponent(rec.path)}"></div>
+                       <div class="result-body">
+                         <div class="result-name" title="${rec.name}">${escapeHtml(rec.name)}</div>
+                         <button class="tag-now-btn btn-primary" data-path="${encodeURIComponent(rec.path)}">⌁ Tag Now</button>
+                       </div>`;
+    card.querySelector(".tag-now-btn").onclick = (e)=>tagNow(rec.path, e.target);
+    grid.appendChild(card);
+  });
+  $("btnLoadMoreUntagged").style.display = untaggedItems.length < untaggedTotal ? "block" : "none";
+}
+$("btnLoadMoreUntagged").onclick = ()=>loadUntagged(false);
+
+async function tagNow(path, btnEl){
+  btnEl.disabled = true; btnEl.textContent = "tagging…";
+  const j = await api("/api/redo_single", {path, settings: engineSettings()});
+  if(j.ok){
+    addLog({level:"ok", msg:`Tagged ${os_basename(path)} → ${j.category}.`, ts:new Date().toTimeString().slice(0,8)});
+    if(currentView === "untagged") loadUntagged(true);
+    else if(currentView === "failed") loadFailed();
+    else if(currentView === "videos") loadVideos(true);
+  } else {
+    btnEl.disabled = false; btnEl.textContent = "⌁ Tag Now (retry)";
+  }
+}
+
+/* ---- failed view ---- */
+async function loadFailed(){
+  const j = await api("/api/failed");
+  const results = j.results || [];
+  $("failedCount").textContent = results.length + " failed photo" + (results.length===1?"":"s");
+  $("btnRetryAllFailed").disabled = results.length === 0;
+  const grid = $("failedGrid");
+  grid.innerHTML = results.length ? "" : `<div class="search-empty">No failures in the queue.</div>`;
+  results.forEach(rec=>{
+    const card = document.createElement("div");
+    card.className = "result-card2";
+    card.innerHTML = `<div class="result-thumb"><img loading="lazy" src="/api/thumbnail?path=${encodeURIComponent(rec.path)}"></div>
+                       <div class="result-body">
+                         <div class="result-name" title="${rec.name}">${escapeHtml(rec.name)}</div>
+                         <button class="tag-now-btn" data-path="${encodeURIComponent(rec.path)}">⌁ Retry</button>
+                       </div>`;
+    card.querySelector(".tag-now-btn").onclick = (e)=>tagNow(rec.path, e.target);
+    grid.appendChild(card);
+  });
+}
+$("btnRetryAllFailed").onclick = async ()=>{
+  $("btnRetryAllFailed").disabled = true;
+  const j = await api("/api/retry_failed");
+  if(j.ok) addLog({level:"info", msg:"Retrying all failed photos…", ts:new Date().toTimeString().slice(0,8)});
+};
+
+/* ---- videos view ---- */
+let videoItems = [], videoTotal = 0, videoLoading = false;
+async function loadVideos(reset){
+  if(videoLoading) return;
+  if(reset) videoItems = [];
+  videoLoading = true;
+  const j = await api("/api/videos?limit=40&offset=" + videoItems.length);
+  videoLoading = false;
+  if(!j.results) return;
+  videoItems.push(...j.results);
+  videoTotal = j.total || 0;
+  $("videosCount").textContent = videoTotal + " video" + (videoTotal===1?"":"s") + " found";
+  const grid = $("videosGrid");
+  grid.innerHTML = videoItems.length ? "" : `<div class="search-empty">No videos found in the last scan.</div>`;
+  videoItems.forEach((rec, i)=>{
+    const card = document.createElement("div");
+    card.className = "result-card2";
+    card.onclick = (e)=>{ if(!e.target.closest(".tag-now-btn")) openVideoLightbox(i); };
+    card.innerHTML = `<div class="result-thumb"><img loading="lazy" src="/api/thumbnail?path=${encodeURIComponent(rec.path)}">
+                        <span class="video-badge">▶ VIDEO</span></div>
+                       <div class="result-body">
+                         <div class="result-name" title="${rec.name}">${escapeHtml(rec.name)}</div>
+                         ${rec.tagged ? '<div class="result-desc2" style="color:var(--grn)">✓ tagged — open to view</div>' :
+                           `<button class="tag-now-btn btn-primary" data-path="${encodeURIComponent(rec.path)}">⌁ Tag Now</button>`}
+                       </div>`;
+    if(!rec.tagged) card.querySelector(".tag-now-btn").onclick = (e)=>{ e.stopPropagation(); tagNow(rec.path, e.target); };
+    grid.appendChild(card);
+  });
+  $("btnLoadMoreVideos").style.display = videoItems.length < videoTotal ? "block" : "none";
+}
+$("btnLoadMoreVideos").onclick = ()=>loadVideos(false);
+
+function openVideoLightbox(i){
+  const rec = videoItems[i];
+  openQuickView({path: rec.path, name: rec.name, desc: "", category: CATS[0] || ""});
+}
+
+/* ---- duplicates view ---- */
+let dedupePollTimer = null;
+async function loadDupeGroups(){
+  const j = await api("/api/dedupe/groups");
+  if(j.dedupeStatus === "running"){
+    $("dupesStatus").textContent = `Hashing photos… ${j.dedupeProgress.done}/${j.dedupeProgress.total}`;
+    $("dupesProgress").style.display = "block";
+    $("dupesProgress").textContent = "Duplicate scan running in the background — this view will update automatically.";
+    $("btnScanDupes").disabled = true;
+    if(!dedupePollTimer) dedupePollTimer = setTimeout(()=>{ dedupePollTimer=null; loadDupeGroups(); }, 3000);
+  } else {
+    $("dupesProgress").style.display = "none";
+    $("btnScanDupes").disabled = false;
+    $("dupesStatus").textContent = `${j.hashed} of ${j.totalImages} photos hashed · ${j.groups.length} duplicate group(s) found`;
+  }
+  const box = $("dupesGroups");
+  if(!j.groups.length){
+    box.innerHTML = `<div class="search-empty">${j.hashed === 0 ? 'Click "Scan for duplicates" to build the index — a one-time pass over your tagged photos.' : 'No exact-match duplicates found.'}</div>`;
+    return;
+  }
+  box.innerHTML = "";
+  j.groups.forEach(g=>{
+    const grp = document.createElement("div");
+    grp.className = "dupe-group";
+    const header = document.createElement("div");
+    header.className = "dupe-group-header";
+    header.textContent = g.count + " visually identical copies";
+    grp.appendChild(header);
+    const rowEl = document.createElement("div");
+    rowEl.className = "dupe-thumb-row";
+    g.items.forEach(rec=>{
+      const t = document.createElement("div");
+      t.className = "dupe-thumb";
+      t.innerHTML = `<img src="/api/thumbnail?path=${encodeURIComponent(rec.path)}">
+                      <div class="name" title="${rec.path}">${escapeHtml(rec.name)}</div>
+                      <button>Reveal in Finder</button>`;
+      t.querySelector("img").onclick = ()=>openQuickView(rec);
+      t.querySelector("button").onclick = ()=>api("/api/reveal", {path: rec.path});
+      rowEl.appendChild(t);
+    });
+    grp.appendChild(rowEl);
+    box.appendChild(grp);
+  });
+}
+$("btnScanDupes").onclick = async ()=>{
+  const j = await api("/api/dedupe/build");
+  if(j.ok){
+    addLog({level:"info", msg:"Duplicate scan started in the background…", ts:new Date().toTimeString().slice(0,8)});
+    loadDupeGroups();
+  }
+};
+
+/* ---- audit history dashboard ---- */
+async function loadAuditHistory(){
+  const j = await api("/api/audit/history");
+  $("ahTotal").textContent = j.total || 0;
+  $("ahAccuracy").textContent = j.total ? j.accuracy + "%" : "—";
+  $("ahPassed").textContent = j.passed || 0;
+  $("ahFailed").textContent = j.failed || 0;
+  const box = $("ahDayChart");
+  box.innerHTML = "";
+  if(!j.byDay || !j.byDay.length){
+    box.innerHTML = `<div style="color:var(--dim); font-size:11px; padding:10px">No audit history yet — run a Blind Accuracy Audit to build one.</div>`;
+    return;
+  }
+  const maxTotal = Math.max(...j.byDay.map(d=>d.pass+d.fail), 1);
+  j.byDay.forEach(d=>{
+    const total = d.pass + d.fail;
+    const acc = total ? Math.round(d.pass/total*100) : 0;
+    const pct = total / maxTotal * 100;
+    const br = document.createElement("div"); br.className = "bar-row";
+    br.innerHTML = `<div class="bar-lbl" title="${d.day}">${d.day}</div>
+                     <div class="bar-track"><div class="bar-fill" style="width:${pct}%"></div></div>
+                     <div class="bar-val">${acc}%</div>`;
+    box.appendChild(br);
+  });
+}
+
 /* ---------- Blind Accuracy Grader ---------- */
 let auditList = [];
 let auditIndex = 0;
@@ -988,6 +1812,14 @@ function connect(){
       // Update recent results strip
       addToRecentStrip(m.data);
     }
+    else if(m.type==="dedupe"){
+      if(currentView === "dupes"){
+        $("dupesStatus").textContent = m.data.finished
+          ? "Hashing complete — rebuilding groups…"
+          : `Hashing photos… ${m.data.done}/${m.data.total}`;
+        if(m.data.finished) loadDupeGroups();
+      }
+    }
   };
   es.onerror = ()=>{ es.close(); setTimeout(connect, 2000); };
 }
@@ -1022,6 +1854,8 @@ function connect(){
   
   populateCategoryDropdowns();
   renderCategoryListEditor();
+  renderSavedSearches();
+  loadAppearanceSettings();
   connect();
 })();
 </script>
diff --git a/server.py b/server.py
index d3a83a5..bcf0011 100644
--- a/server.py
+++ b/server.py
@@ -23,12 +23,56 @@ import time
 import urllib.request
 import urllib.error
 import urllib.parse
+import zipfile
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 
 APP_DIR = os.path.dirname(os.path.abspath(__file__))
 OLLAMA = "http://localhost:11434"
-PORT = 8765
-DEFAULT_FOLDER = "/Volumes/sanD/allphotos from phone"
+PORT = int(os.environ.get("PHOTON_PORT", 8765))
+
+FOLDER_CONFIG_FILE = os.path.join(APP_DIR, "photon_folder.json")
+
+def load_saved_folder():
+    if os.path.exists(FOLDER_CONFIG_FILE):
+        try:
+            with open(FOLDER_CONFIG_FILE, "r", encoding="utf-8") as f:
+                folder = json.load(f).get("folder")
+            if folder and os.path.isdir(folder):
+                return folder
+        except Exception:
+            pass
+    return None
+
+def save_folder_config(folder):
+    try:
+        with open(FOLDER_CONFIG_FILE, "w", encoding="utf-8") as f:
+            json.dump({"folder": folder}, f)
+    except Exception:
+        pass
+
+def resolve_default_folder():
+    """Zero-config folder detection, in priority order:
+    1. `python3 server.py /path/to/photos` — explicit CLI argument
+    2. PHOTON_FOLDER env var
+    3. the last folder scanned in a previous session (remembered automatically)
+    4. the parent directory of wherever this app folder lives — the intended
+       workflow is dropping the PHOTON folder directly inside a photo
+       collection, so its parent IS that collection.
+    Always overridable from the Console tab's folder field + Scan button.
+    """
+    if len(sys.argv) > 1:
+        arg = os.path.abspath(sys.argv[1])
+        if os.path.isdir(arg):
+            return arg
+    env = os.environ.get("PHOTON_FOLDER")
+    if env and os.path.isdir(env):
+        return os.path.abspath(env)
+    saved = load_saved_folder()
+    if saved:
+        return saved
+    return os.path.dirname(APP_DIR)
+
+DEFAULT_FOLDER = resolve_default_folder()
 JOURNAL = os.path.join(APP_DIR, "photon_journal.jsonl")
 CATEGORIES_FILE = os.path.join(APP_DIR, "photon_categories.json")
 
@@ -124,9 +168,12 @@ class State:
         self.status = "idle"          # idle | scanning | running | paused | stopping | done
         self.folder = DEFAULT_FOLDER
         self.files = []               # pending image paths (after scan)
+        self.video_files = []         # video paths found on last scan
         self.total_images = 0
         self.skipped_videos = 0
         self.skipped_sidecars = 0
+        self.dedupe_status = "idle"   # idle | running
+        self.dedupe_progress = {"done": 0, "total": 0}
         self.already_done = 0
         self.processed_session = 0
         self.failed_session = 0
@@ -195,6 +242,203 @@ def journal_write(rec):
     with open(JOURNAL, "a", encoding="utf-8") as f:
         f.write(json.dumps(rec, ensure_ascii=False) + "\n")
 
+SEARCH_CACHE = {"mtime": None, "records": []}
+
+def load_search_index():
+    """Journal records with a precomputed lowercase haystack, cached by file mtime."""
+    global SEARCH_CACHE
+    if not os.path.exists(JOURNAL):
+        SEARCH_CACHE = {"mtime": None, "records": []}
+        return []
+    mtime = os.path.getmtime(JOURNAL)
+    if SEARCH_CACHE["mtime"] == mtime:
+        return SEARCH_CACHE["records"]
+    records = []
+    with open(JOURNAL, "r", encoding="utf-8") as f:
+        for line in f:
+            line = line.strip()
+            if not line:
+                continue
+            try:
+                rec = json.loads(line)
+                path = rec.get("path", "")
+                name = os.path.basename(path)
+                rec["name"] = name
+                rec["_ext"] = os.path.splitext(name)[1].lower()
+                rec["_hay"] = " ".join([
+                    path.lower(), (rec.get("desc") or "").lower(),
+                    (rec.get("category") or "").lower(), name.lower()
+                ])
+                try:
+                    st = os.stat(path)
+                    rec["_mtime"] = st.st_mtime
+                    rec["sizeBytes"] = st.st_size
+                except OSError:
+                    rec["_mtime"] = rec.get("ts", 0)
+                    rec["sizeBytes"] = None
+                records.append(rec)
+            except Exception:
+                pass
+    SEARCH_CACHE = {"mtime": mtime, "records": records}
+    return records
+
+def parse_date_bound(s, end_of_day=False):
+    if not s:
+        return None
+    try:
+        t = time.strptime(s, "%Y-%m-%d")
+        epoch = time.mktime(t)
+        return epoch + 86399 if end_of_day else epoch
+    except Exception:
+        return None
+
+def filtered_search_results(q, cat, date_from, date_to, sort, ftype=""):
+    records = load_search_index()
+    tokens = (q or "").strip().lower().split()
+    df = parse_date_bound(date_from)
+    dt = parse_date_bound(date_to, end_of_day=True)
+
+    def matches(rec):
+        if cat and rec.get("category") != cat:
+            return False
+        if ftype == "photo" and rec.get("_ext") not in IMAGE_EXTS:
+            return False
+        if ftype == "video" and rec.get("_ext") not in VIDEO_EXTS:
+            return False
+        if df is not None and rec.get("_mtime", 0) < df:
+            return False
+        if dt is not None and rec.get("_mtime", 0) > dt:
+            return False
+        if not tokens:
+            return True
+        hay = rec.get("_hay", "")
+        return all(t in hay for t in tokens)
+
+    filtered = [r for r in records if matches(r)]
+    if sort == "name":
+        filtered.sort(key=lambda r: r.get("name", "").lower())
+    elif sort == "category":
+        filtered.sort(key=lambda r: ((r.get("category") or ""), r.get("name", "").lower()))
+    else:
+        filtered.sort(key=lambda r: r.get("ts", 0), reverse=True)
+    return filtered
+
+# ---------------------------------------------------------------- duplicate detection
+
+PHASH_FILE = os.path.join(APP_DIR, "photon_phash.json")
+PHASH_CACHE = {}
+PHASH_LOCK = threading.Lock()
+
+def load_phash_cache():
+    global PHASH_CACHE
+    with PHASH_LOCK:
+        if PHASH_CACHE:
+            return PHASH_CACHE
+        if os.path.exists(PHASH_FILE):
+            try:
+                with open(PHASH_FILE, "r", encoding="utf-8") as f:
+                    PHASH_CACHE = json.load(f)
+            except Exception:
+                PHASH_CACHE = {}
+        return PHASH_CACHE
+
+def save_phash_cache():
+    with PHASH_LOCK:
+        try:
+            with open(PHASH_FILE, "w", encoding="utf-8") as f:
+                json.dump(PHASH_CACHE, f)
+        except Exception:
+            pass
+
+def compute_phash(path):
+    """8x8 grayscale average-hash via sips + manual BMP parsing. No external deps."""
+    tmp_path = os.path.join(tempfile.gettempdir(), f"photon_ph_{os.getpid()}_{threading.get_ident()}.bmp")
+    try:
+        cmd = ["sips", "-s", "format", "bmp", "-z", "8", "8", path, "--out", tmp_path]
+        r = subprocess.run(cmd, capture_output=True, timeout=20)
+        if r.returncode != 0 or not os.path.exists(tmp_path):
+            return None
+        with open(tmp_path, "rb") as f:
+            data = f.read()
+        if data[0:2] != b"BM":
+            return None
+        pixel_offset = int.from_bytes(data[10:14], "little")
+        width = int.from_bytes(data[18:22], "little")
+        height = int.from_bytes(data[22:26], "little")
+        bpp = int.from_bytes(data[28:30], "little")
+        if bpp not in (24, 32) or width <= 0 or height <= 0:
+            return None
+        row_bytes = width * (bpp // 8)
+        row_padded = (row_bytes + 3) & ~3
+        grays = []
+        for y in range(height):
+            row_start = pixel_offset + y * row_padded
+            for x in range(width):
+                px = row_start + x * (bpp // 8)
+                if px + 2 >= len(data):
+                    return None
+                b, g, rr = data[px], data[px + 1], data[px + 2]
+                grays.append((rr * 299 + g * 587 + b * 114) // 1000)
+        if not grays:
+            return None
+        avg = sum(grays) / len(grays)
+        bits = "".join("1" if p >= avg else "0" for p in grays)
+        return f"{int(bits, 2):0{len(bits)//4}x}"
+    except Exception:
+        return None
+    finally:
+        try:
+            os.remove(tmp_path)
+        except OSError:
+            pass
+
+def build_dedupe_index():
+    """Background worker: hash every tagged image not yet in the phash cache."""
+    with S.lock:
+        if S.dedupe_status == "running":
+            return
+        S.dedupe_status = "running"
+    try:
+        records = load_search_index()
+        paths = [r["path"] for r in records
+                 if os.path.splitext(r["path"])[1].lower() in IMAGE_EXTS]
+        cache = load_phash_cache()
+        todo = [p for p in paths if p not in cache]
+        total = len(todo)
+        with S.lock:
+            S.dedupe_progress = {"done": 0, "total": total}
+        log("info", f"duplicate scan: hashing {total} photos …")
+        for i, p in enumerate(todo):
+            if not os.path.exists(p):
+                continue
+            h = compute_phash(p)
+            if h:
+                cache[p] = h
+            if i % 50 == 0:
+                save_phash_cache()
+            with S.lock:
+                S.dedupe_progress = {"done": i + 1, "total": total}
+            if i % 25 == 0:
+                broadcast("dedupe", {"done": i + 1, "total": total})
+        save_phash_cache()
+        broadcast("dedupe", {"done": total, "total": total, "finished": True})
+        log("ok", f"duplicate scan complete: {total} photos hashed")
+    finally:
+        with S.lock:
+            S.dedupe_status = "idle"
+
+def find_duplicate_groups():
+    """Groups of exact perceptual-hash matches — visually identical / re-saved copies."""
+    records = {r["path"]: r for r in load_search_index()}
+    cache = load_phash_cache()
+    by_hash = {}
+    for path, h in cache.items():
+        if path in records:
+            by_hash.setdefault(h, []).append(records[path])
+    groups = [g for g in by_hash.values() if len(g) > 1]
+    groups.sort(key=len, reverse=True)
+    return groups
+
 # ---------------------------------------------------------------- SSE
 
 def broadcast(kind, data):
@@ -302,7 +546,7 @@ def ollama_generate(model, prompt, img_b64, opts, keep_alive, think=None, schema
 # ---------------------------------------------------------------- pipeline
 
 def scan_folder(folder):
-    images, videos, sidecars = [], 0, 0
+    images, videos, sidecars = [], [], 0
     for root, dirs, files in os.walk(folder):
         dirs[:] = [d for d in dirs if not d.startswith(".") and not d.startswith("_")]
         for name in sorted(files):
@@ -313,7 +557,7 @@ def scan_folder(folder):
             if ext in IMAGE_EXTS:
                 images.append(os.path.join(root, name))
             elif ext in VIDEO_EXTS:
-                videos += 1
+                videos.append(os.path.join(root, name))
     return images, videos, sidecars
 
 def organize_alias(folder, file_path, category):
@@ -418,6 +662,38 @@ def downscale(path, max_px, tmpdir):
     with open(out, "rb") as f:
         return f.read()
 
+def extract_video_frame(path, tmpdir):
+    """Grab one representative frame from a video via ffmpeg (read-only). Returns a jpeg file path."""
+    out = os.path.join(tmpdir, "photon_vframe.jpg")
+    dur = 3.0
+    try:
+        pr = subprocess.run(
+            ["ffprobe", "-v", "error", "-show_entries", "format=duration",
+             "-of", "default=noprint_wrappers=1:nokey=1", path],
+            capture_output=True, timeout=15, text=True)
+        dur = float(pr.stdout.strip())
+    except Exception:
+        pass
+    ts = max(0.5, min(dur * 0.3, max(dur - 0.2, 0.5))) if dur > 1 else 0.1
+    cmd = ["ffmpeg", "-y", "-ss", str(ts), "-i", path, "-frames:v", "1", "-q:v", "3", out]
+    r = subprocess.run(cmd, capture_output=True, timeout=60)
+    if r.returncode != 0 or not os.path.exists(out):
+        raise RuntimeError(f"ffmpeg frame extraction failed: {r.stderr.decode(errors='replace')[:200]}")
+    return out
+
+def video_thumbnail(path, out_path):
+    """Cheap ffmpeg frame-grab thumbnail for the browsing grid (read-only)."""
+    cmd = ["ffmpeg", "-y", "-ss", "1", "-i", path, "-frames:v", "1",
+           "-vf", "scale=256:-1", "-q:v", "5", out_path]
+    r = subprocess.run(cmd, capture_output=True, timeout=30)
+    if r.returncode != 0 or not os.path.exists(out_path):
+        # very short clips: fall back to the first frame
+        cmd2 = ["ffmpeg", "-y", "-i", path, "-frames:v", "1",
+                "-vf", "scale=256:-1", "-q:v", "5", out_path]
+        r = subprocess.run(cmd2, capture_output=True, timeout=30)
+        if r.returncode != 0 or not os.path.exists(out_path):
+            raise RuntimeError(r.stderr.decode(errors="replace")[:200])
+
 def salvage_json(raw):
     """Parse model output, surviving truncated/unterminated JSON."""
     try:
@@ -465,28 +741,39 @@ def build_prompt(length_key, mode="photo"):
     )
 
 def write_metadata(path, desc, category, keep_backup, preserve_date):
+    is_video = os.path.splitext(path)[1].lower() in VIDEO_EXTS
     args = ["exiftool", "-m", "-q", "-codedcharacterset=utf8"]
     if preserve_date:
         args.append("-P")
     if not keep_backup:
         args.append("-overwrite_original")   # writes temp file then atomic rename
-    args += [
-        f"-EXIF:ImageDescription={desc}",
-        f"-IPTC:Caption-Abstract={desc}",
-        f"-XMP-dc:Description={desc}",
-        f"-XMP-dc:Subject+={category}",
-        f"-IPTC:Keywords+={category}",
-        "-XMP-dc:Subject+=photon-tagged",
-        path,
-    ]
+    if is_video:
+        # mp4/mov containers don't carry EXIF/IPTC — use exiftool's generic
+        # tag names so it resolves to QuickTime/Keys groups automatically.
+        args += [
+            f"-Description={desc}",
+            f"-Keywords+={category}",
+            "-Keywords+=photon-tagged",
+        ]
+    else:
+        args += [
+            f"-EXIF:ImageDescription={desc}",
+            f"-IPTC:Caption-Abstract={desc}",
+            f"-XMP-dc:Description={desc}",
+            f"-XMP-dc:Subject+={category}",
+            f"-IPTC:Keywords+={category}",
+            "-XMP-dc:Subject+=photon-tagged",
+        ]
+    args.append(path)
     r = subprocess.run(args, capture_output=True, timeout=120)
     if r.returncode != 0:
         raise RuntimeError(f"exiftool: {r.stderr.decode(errors='replace')[:300]}")
 
 def sync_metadata_from_folder(folder):
     log("info", f"Syncing journal with folder metadata: {folder} ...")
-    cmd = ["exiftool", "-r", "-json", "-if", "$Subject =~ /photon-tagged/", 
-           "-EXIF:ImageDescription", "-XMP-dc:Description", "-IPTC:Caption-Abstract",
+    cmd = ["exiftool", "-r", "-json", "-if",
+           "$Subject =~ /photon-tagged/ or $Keywords =~ /photon-tagged/",
+           "-EXIF:ImageDescription", "-XMP-dc:Description", "-IPTC:Caption-Abstract", "-Description",
            "-XMP-dc:Subject", "-IPTC:Keywords", folder]
     r = subprocess.run(cmd, capture_output=True, timeout=300)
     if r.returncode != 0:
@@ -826,6 +1113,40 @@ class Handler(BaseHTTPRequestHandler):
         self.end_headers()
         self.wfile.write(body)
 
+    def _serve_file_with_range(self, path, ctype):
+        """Basic HTTP Range support, needed for native <video> seeking."""
+        try:
+            size = os.path.getsize(path)
+            range_hdr = self.headers.get("Range")
+            start, end = 0, size - 1
+            status = 200
+            if range_hdr and range_hdr.startswith("bytes="):
+                status = 206
+                rng = range_hdr[6:].split("-")
+                if rng[0]:
+                    start = int(rng[0])
+                if len(rng) > 1 and rng[1]:
+                    end = int(rng[1])
+                end = min(end, size - 1)
+            length = end - start + 1
+            with open(path, "rb") as f:
+                f.seek(start)
+                data = f.read(length)
+            self.send_response(status)
+            self.send_header("Content-Type", ctype)
+            self.send_header("Accept-Ranges", "bytes")
+            self.send_header("Content-Length", str(len(data)))
+            if status == 206:
+                self.send_header("Content-Range", f"bytes {start}-{end}/{size}")
+            self.send_header("Cache-Control", "no-store")
+            self.end_headers()
+            self.wfile.write(data)
+        except (BrokenPipeError, ConnectionResetError):
+            pass
+        except Exception as e:
+            self.send_response(500); self.end_headers()
+            self.wfile.write(str(e).encode())
+
     def do_GET(self):
         if self.path == "/" or self.path.startswith("/index"):
             with open(os.path.join(APP_DIR, "index.html"), "rb") as f:
@@ -872,11 +1193,15 @@ class Handler(BaseHTTPRequestHandler):
                 os.makedirs(cache_dir, exist_ok=True)
                 h = hashlib.md5(abs_path.encode()).hexdigest()
                 thumb_path = os.path.join(cache_dir, f"{h}.jpg")
+                is_video = os.path.splitext(abs_path)[1].lower() in VIDEO_EXTS
                 if not os.path.exists(thumb_path):
-                    cmd = ["sips", "-s", "format", "jpeg", "-s", "formatOptions", "70", "-Z", "256", abs_path, "--out", thumb_path]
-                    r = subprocess.run(cmd, capture_output=True, timeout=15)
-                    if r.returncode != 0:
-                        raise RuntimeError(f"sips failed: {r.stderr.decode(errors='replace')}")
+                    if is_video:
+                        video_thumbnail(abs_path, thumb_path)
+                    else:
+                        cmd = ["sips", "-s", "format", "jpeg", "-s", "formatOptions", "70", "-Z", "256", abs_path, "--out", thumb_path]
+                        r = subprocess.run(cmd, capture_output=True, timeout=15)
+                        if r.returncode != 0:
+                            raise RuntimeError(f"sips failed: {r.stderr.decode(errors='replace')}")
                 with open(thumb_path, "rb") as f:
                     data = f.read()
                 self.send_response(200)
@@ -888,35 +1213,258 @@ class Handler(BaseHTTPRequestHandler):
             except Exception as e:
                 self.send_response(500); self.end_headers()
                 self.wfile.write(str(e).encode())
+        elif self.path.startswith("/api/photo"):
+            parsed_url = urllib.parse.urlparse(self.path)
+            params = urllib.parse.parse_qs(parsed_url.query)
+            img_path = params.get("path", [""])[0]
+            if not img_path or not os.path.exists(img_path):
+                self.send_response(404); self.end_headers(); return
+            abs_path = os.path.abspath(img_path)
+            with S.lock:
+                folder_ok = abs_path.startswith(os.path.abspath(S.folder))
+                journal_ok = abs_path in S.done_paths
+            if not (folder_ok or journal_ok):
+                self.send_response(403); self.end_headers(); return
+            ext = os.path.splitext(abs_path)[1].lower()
+            serve_path = abs_path
+            ctype = {
+                ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".png": "image/png",
+                ".webp": "image/webp", ".heic": "image/heic", ".heif": "image/heif",
+                ".tif": "image/tiff", ".tiff": "image/tiff",
+                ".mov": "video/quicktime", ".mp4": "video/mp4", ".m4v": "video/mp4",
+                ".avi": "video/x-msvideo", ".3gp": "video/3gpp", ".mkv": "video/x-matroska",
+            }.get(ext, "application/octet-stream")
+            if ext in VIDEO_EXTS:
+                self._serve_file_with_range(abs_path, ctype)
+                return
+            if ext in (".heic", ".heif", ".tif", ".tiff"):
+                # browsers other than Safari can't render these — serve a read-only
+                # full-size jpeg conversion via sips, cached, original untouched.
+                try:
+                    cache_dir = os.path.join(tempfile.gettempdir(), "photon_view")
+                    os.makedirs(cache_dir, exist_ok=True)
+                    h = hashlib.md5(abs_path.encode()).hexdigest()
+                    view_path = os.path.join(cache_dir, f"{h}.jpg")
+                    if not os.path.exists(view_path) or os.path.getmtime(abs_path) > os.path.getmtime(view_path):
+                        cmd = ["sips", "-s", "format", "jpeg", "-s", "formatOptions", "92",
+                               "-Z", "2200", abs_path, "--out", view_path]
+                        r = subprocess.run(cmd, capture_output=True, timeout=30)
+                        if r.returncode != 0 or not os.path.exists(view_path):
+                            raise RuntimeError(r.stderr.decode(errors="replace")[:200])
+                    serve_path = view_path
+                    ctype = "image/jpeg"
+                except Exception as e:
+                    self.send_response(500); self.end_headers()
+                    self.wfile.write(str(e).encode())
+                    return
+            try:
+                with open(serve_path, "rb") as f:
+                    data = f.read()
+                self.send_response(200)
+                self.send_header("Content-Type", ctype)
+                self.send_header("Content-Length", str(len(data)))
+                self.send_header("Cache-Control", "no-store")
+                self.end_headers()
+                self.wfile.write(data)
+            except Exception as e:
+                self.send_response(500); self.end_headers()
+                self.wfile.write(str(e).encode())
+        elif self.path.startswith("/api/search/paths"):
+            parsed_url = urllib.parse.urlparse(self.path)
+            params = urllib.parse.parse_qs(parsed_url.query)
+            q = params.get("q", [""])[0]
+            cat = params.get("cat", [""])[0]
+            sort = params.get("sort", ["recent"])[0]
+            date_from = params.get("date_from", [""])[0]
+            date_to = params.get("date_to", [""])[0]
+            ftype = params.get("ftype", [""])[0]
+            filtered = filtered_search_results(q, cat, date_from, date_to, sort, ftype)
+            MAX_SELECT = 3000
+            paths = [r["path"] for r in filtered[:MAX_SELECT]]
+            self._json({"paths": paths, "total": len(filtered), "capped": len(filtered) > MAX_SELECT})
+
         elif self.path.startswith("/api/search"):
             parsed_url = urllib.parse.urlparse(self.path)
             params = urllib.parse.parse_qs(parsed_url.query)
-            q = params.get("q", [""])[0].strip().lower()
+            q = params.get("q", [""])[0]
+            cat = params.get("cat", [""])[0]
+            sort = params.get("sort", ["recent"])[0]
+            date_from = params.get("date_from", [""])[0]
+            date_to = params.get("date_to", [""])[0]
+            ftype = params.get("ftype", [""])[0]
+            try:
+                limit = max(1, min(200, int(params.get("limit", ["60"])[0])))
+            except ValueError:
+                limit = 60
+            try:
+                offset = max(0, int(params.get("offset", ["0"])[0]))
+            except ValueError:
+                offset = 0
             re_read = params.get("re_read", ["0"])[0] == "1"
             if re_read:
                 with S.lock:
                     folder = S.folder
                 sync_metadata_from_folder(folder)
                 push_stats()
-            results = []
-            if os.path.exists(JOURNAL):
-                with open(JOURNAL, "r", encoding="utf-8") as f:
-                    for line in f:
-                        line = line.strip()
-                        if not line:
-                            continue
+
+            filtered = filtered_search_results(q, cat, date_from, date_to, sort, ftype)
+            total = len(filtered)
+            page = [{k: v for k, v in r.items() if k not in ("_hay", "_mtime", "_ext")} for r in filtered[offset:offset + limit]]
+            self._json({"results": page, "total": total, "offset": offset, "limit": limit})
+
+        elif self.path.startswith("/api/export"):
+            parsed_url = urllib.parse.urlparse(self.path)
+            params = urllib.parse.parse_qs(parsed_url.query)
+            q = params.get("q", [""])[0]
+            cat = params.get("cat", [""])[0]
+            sort = params.get("sort", ["recent"])[0]
+            date_from = params.get("date_from", [""])[0]
+            date_to = params.get("date_to", [""])[0]
+            ftype = params.get("ftype", [""])[0]
+            fmt = params.get("format", ["json"])[0]
+            paths_only = params.get("paths", [""])[0].split(",") if params.get("paths", [""])[0] else None
+
+            filtered = filtered_search_results(q, cat, date_from, date_to, sort, ftype)
+            if paths_only:
+                wanted = set(paths_only)
+                filtered = [r for r in filtered if r["path"] in wanted]
+
+            if fmt == "csv":
+                import csv, io
+                buf = io.StringIO()
+                w = csv.writer(buf)
+                w.writerow(["path", "name", "category", "description", "model", "route", "tagged_at"])
+                for r in filtered:
+                    w.writerow([r.get("path", ""), r.get("name", ""), r.get("category", ""),
+                                r.get("desc", ""), r.get("model", ""), r.get("route", ""),
+                                time.strftime("%Y-%m-%d %H:%M:%S", time.localtime(r.get("ts", 0))) if r.get("ts") else ""])
+                body = buf.getvalue().encode("utf-8")
+                ctype = "text/csv"
+                fname = "photon_export.csv"
+            else:
+                page = [{k: v for k, v in r.items() if k not in ("_hay", "_mtime", "_ext")} for r in filtered]
+                body = json.dumps(page, ensure_ascii=False, indent=2).encode("utf-8")
+                ctype = "application/json"
+                fname = "photon_export.json"
+
+            self.send_response(200)
+            self.send_header("Content-Type", ctype)
+            self.send_header("Content-Disposition", f'attachment; filename="{fname}"')
+            self.send_header("Content-Length", str(len(body)))
+            self.end_headers()
+            self.wfile.write(body)
+
+        elif self.path.startswith("/api/untagged"):
+            parsed_url = urllib.parse.urlparse(self.path)
+            params = urllib.parse.parse_qs(parsed_url.query)
+            try:
+                limit = max(1, min(200, int(params.get("limit", ["60"])[0])))
+            except ValueError:
+                limit = 60
+            try:
+                offset = max(0, int(params.get("offset", ["0"])[0]))
+            except ValueError:
+                offset = 0
+            with S.lock:
+                pending = [p for p in S.files if p not in S.done_paths]
+            total = len(pending)
+            page = [{"path": p, "name": os.path.basename(p)} for p in pending[offset:offset + limit]]
+            self._json({"results": page, "total": total, "offset": offset, "limit": limit})
+
+        elif self.path.startswith("/api/failed"):
+            with S.lock:
+                paths = sorted(S.failed_paths)
+            results = [{"path": p, "name": os.path.basename(p)} for p in paths]
+            self._json({"results": results, "total": len(results)})
+
+        elif self.path.startswith("/api/videos"):
+            parsed_url = urllib.parse.urlparse(self.path)
+            params = urllib.parse.parse_qs(parsed_url.query)
+            try:
+                limit = max(1, min(200, int(params.get("limit", ["40"])[0])))
+            except ValueError:
+                limit = 40
+            try:
+                offset = max(0, int(params.get("offset", ["0"])[0]))
+            except ValueError:
+                offset = 0
+            with S.lock:
+                vids = list(S.video_files)
+                done = set(S.done_paths)
+            total = len(vids)
+            page = [{"path": p, "name": os.path.basename(p), "tagged": p in done}
+                    for p in vids[offset:offset + limit]]
+            self._json({"results": page, "total": total, "offset": offset, "limit": limit})
+
+        elif self.path.startswith("/api/dedupe/groups"):
+            groups = find_duplicate_groups()
+            payload = [
+                {"hash": None, "count": len(g),
+                 "items": [{k: v for k, v in r.items() if k not in ("_hay", "_mtime", "_ext")} for r in g]}
+                for g in groups
+            ]
+            cache = load_phash_cache()
+            with S.lock:
+                total_images = len([p for p in S.done_paths if os.path.splitext(p)[1].lower() in IMAGE_EXTS])
+            self._json({"groups": payload, "hashed": len(cache), "totalImages": total_images,
+                        "dedupeStatus": S.dedupe_status, "dedupeProgress": S.dedupe_progress})
+
+        elif self.path.startswith("/api/download_zip"):
+            parsed_url = urllib.parse.urlparse(self.path)
+            params = urllib.parse.parse_qs(parsed_url.query)
+            paths_param = params.get("paths", [""])[0]
+            if paths_param:
+                paths = paths_param.split(",")
+            else:
+                q = params.get("q", [""])[0]
+                cat = params.get("cat", [""])[0]
+                sort = params.get("sort", ["recent"])[0]
+                date_from = params.get("date_from", [""])[0]
+                date_to = params.get("date_to", [""])[0]
+                ftype = params.get("ftype", [""])[0]
+                paths = [r["path"] for r in filtered_search_results(q, cat, date_from, date_to, sort, ftype)]
+
+            paths = [p for p in paths if p and os.path.exists(p)]
+            if not paths:
+                self._json({"error": "no files to download"}, 400); return
+            if len(paths) > 3000:
+                self._json({"error": f"too many files for one zip ({len(paths)}, max 3000) — narrow your selection"}, 400); return
+
+            tmp_zip = tempfile.NamedTemporaryFile(suffix=".zip", delete=False)
+            tmp_zip.close()
+            try:
+                used_names = set()
+                with zipfile.ZipFile(tmp_zip.name, "w", zipfile.ZIP_STORED, allowZip64=True) as zf:
+                    for p in paths:
+                        name = os.path.basename(p)
+                        base, ext = os.path.splitext(name)
+                        n, i = name, 1
+                        while n in used_names:
+                            n = f"{base}_{i}{ext}"; i += 1
+                        used_names.add(n)
+                        # original bytes, untouched — this is a read-only archive of the source files
+                        zf.write(p, arcname=n)
+                size = os.path.getsize(tmp_zip.name)
+                self.send_response(200)
+                self.send_header("Content-Type", "application/zip")
+                self.send_header("Content-Disposition", f'attachment; filename="photon_{len(paths)}_photos.zip"')
+                self.send_header("Content-Length", str(size))
+                self.end_headers()
+                with open(tmp_zip.name, "rb") as f:
+                    while True:
+                        chunk = f.read(1024 * 1024)
+                        if not chunk:
+                            break
                         try:
-                            rec = json.loads(line)
-                            path = rec.get("path", "")
-                            desc = rec.get("desc", "")
-                            category = rec.get("category", "")
-                            name = os.path.basename(path)
-                            if (not q) or (q in path.lower()) or (q in desc.lower()) or (q in category.lower()) or (q in name.lower()):
-                                rec["name"] = name
-                                results.append(rec)
-                        except Exception:
-                            pass
-            self._json({"results": results})
+                            self.wfile.write(chunk)
+                        except (BrokenPipeError, ConnectionResetError):
+                            break
+            finally:
+                try:
+                    os.remove(tmp_zip.name)
+                except OSError:
+                    pass
+
         elif self.path == "/api/categories":
             self._json({"categories": CATEGORIES})
         elif self.path == "/api/audit/start":
@@ -935,6 +1483,29 @@ class Handler(BaseHTTPRequestHandler):
                 sampled = records
                 random.shuffle(sampled)
             self._json({"results": sampled})
+        elif self.path == "/api/audit/history":
+            audit_file = os.path.join(APP_DIR, "photon_audits.jsonl")
+            entries = []
+            if os.path.exists(audit_file):
+                with open(audit_file, "r", encoding="utf-8") as f:
+                    for line in f:
+                        try:
+                            entries.append(json.loads(line))
+                        except Exception:
+                            pass
+            passed = sum(1 for e in entries if e.get("grade") == "pass")
+            failed = sum(1 for e in entries if e.get("grade") == "fail")
+            by_day = {}
+            for e in entries:
+                day = time.strftime("%Y-%m-%d", time.localtime(e.get("ts", 0)))
+                d = by_day.setdefault(day, {"pass": 0, "fail": 0})
+                d[e.get("grade", "fail")] += 1
+            days = sorted(by_day.keys())[-14:]
+            self._json({
+                "total": len(entries), "passed": passed, "failed": failed,
+                "accuracy": round(passed / len(entries) * 100, 1) if entries else 0,
+                "byDay": [{"day": d, **by_day[d]} for d in days],
+            })
         elif self.path == "/api/events":
             self.send_response(200)
             self.send_header("Content-Type", "text/event-stream")
@@ -974,6 +1545,7 @@ class Handler(BaseHTTPRequestHandler):
                 if S.status == "running":
                     self._json({"error": "stop the run before rescanning"}, 400); return
                 S.status = "scanning"; S.folder = folder
+            save_folder_config(folder)
             broadcast("state", {"status": "scanning"})
             log("info", f"scanning {folder} …")
             images, videos, sidecars = scan_folder(folder)
@@ -981,14 +1553,15 @@ class Handler(BaseHTTPRequestHandler):
             with S.lock:
                 S.files = images
                 S.total_images = len(images)
-                S.skipped_videos = videos
+                S.video_files = videos
+                S.skipped_videos = len(videos)
                 S.skipped_sidecars = sidecars
                 S.status = "idle"
-            log("ok", f"scan complete: {len(images)} images | {videos} videos skipped | "
+            log("ok", f"scan complete: {len(images)} images | {len(videos)} videos found | "
                       f"{sidecars} hidden/sidecar files ignored | {done} already tagged")
             broadcast("state", {"status": "idle"})
             push_stats()
-            self._json({"images": len(images), "videos": videos,
+            self._json({"images": len(images), "videos": len(videos),
                         "sidecars": sidecars, "alreadyDone": done})
 
         elif self.path == "/api/start":
@@ -1040,12 +1613,13 @@ class Handler(BaseHTTPRequestHandler):
             with S.lock:
                 folder = S.folder
             log("warn", f"UNDO ALL: Removing all PHOTON metadata from files in {folder} ...")
-            args = ["exiftool", "-r", "-P", "-overwrite_original", "-if", "$Subject =~ /photon-tagged/",
-                    "-EXIF:ImageDescription=", "-IPTC:Caption-Abstract=", "-XMP-dc:Description=",
-                    "-XMP-dc:Subject-=photon-tagged", "-IPTC:Keywords-=photon-tagged"]
+            args = ["exiftool", "-r", "-P", "-overwrite_original", "-if",
+                    "$Subject =~ /photon-tagged/ or $Keywords =~ /photon-tagged/",
+                    "-EXIF:ImageDescription=", "-IPTC:Caption-Abstract=", "-XMP-dc:Description=", "-Description=",
+                    "-XMP-dc:Subject-=photon-tagged", "-Keywords-=photon-tagged"]
             for cat in CATEGORIES:
                 args.append(f"-XMP-dc:Subject-={cat}")
-                args.append(f"-IPTC:Keywords-={cat}")
+                args.append(f"-Keywords-={cat}")
             args.append(folder)
             r = subprocess.run(args, capture_output=True, timeout=600)
             log("info", f"Exiftool undo completed: {r.stdout.decode(errors='replace')[:200]}")
@@ -1140,6 +1714,10 @@ class Handler(BaseHTTPRequestHandler):
                 with open(JOURNAL, "w", encoding="utf-8") as f:
                     for rec in existing_recs:
                         f.write(json.dumps(rec, ensure_ascii=False) + "\n")
+                with S.lock:
+                    if path in S.failed_paths:
+                        S.failed_paths.remove(path)
+                        write_failures()
                 load_journal()
                 push_stats()
                 self._json({"ok": True, "desc": desc, "category": category})
@@ -1181,7 +1759,9 @@ class Handler(BaseHTTPRequestHandler):
                     think = False
                     
                 tmpdir = tempfile.mkdtemp(prefix="photon_redo_")
-                img = downscale(path, max_px, tmpdir)
+                is_video = os.path.splitext(path)[1].lower() in VIDEO_EXTS
+                frame_source = extract_video_frame(path, tmpdir) if is_video else path
+                img = downscale(frame_source, max_px, tmpdir)
                 b64 = base64.b64encode(img).decode()
                 
                 route = None
@@ -1249,6 +1829,10 @@ class Handler(BaseHTTPRequestHandler):
                     shutil.rmtree(tmpdir)
                 except Exception:
                     pass
+                with S.lock:
+                    if path in S.failed_paths:
+                        S.failed_paths.remove(path)
+                        write_failures()
                 load_journal()
                 push_stats()
                 self._json({"ok": True, "desc": desc, "category": category, "route": route})
@@ -1280,13 +1864,63 @@ class Handler(BaseHTTPRequestHandler):
             except Exception as e:
                 self._json({"error": str(e)}, 500)
 
+        elif self.path == "/api/dedupe/build":
+            with S.lock:
+                already_running = S.dedupe_status == "running"
+            if already_running:
+                self._json({"error": "duplicate scan already running"}, 400); return
+            threading.Thread(target=build_dedupe_index, daemon=True).start()
+            self._json({"ok": True})
+
+        elif self.path == "/api/bulk_recategorize":
+            paths = body.get("paths") or []
+            category = body.get("category")
+            if not paths or category not in CATEGORIES:
+                self._json({"error": "bad request"}, 400); return
+            records = {r["path"]: r for r in load_search_index()}
+            with S.lock:
+                keep_backup = bool(S.settings.get("keepBackup", False))
+                preserve_date = bool(S.settings.get("preserveDate", True))
+            ok, failed = 0, []
+            for p in paths:
+                rec = records.get(p)
+                desc = rec.get("desc", "") if rec else ""
+                try:
+                    write_metadata(p, desc, category, keep_backup, preserve_date)
+                    ok += 1
+                except Exception as e:
+                    failed.append({"path": p, "error": str(e)})
+            existing_recs = []
+            wanted = set(paths)
+            if os.path.exists(JOURNAL):
+                with open(JOURNAL, "r", encoding="utf-8") as f:
+                    for line in f:
+                        try:
+                            rec = json.loads(line)
+                            if rec["path"] in wanted and not any(fe["path"] == rec["path"] for fe in failed):
+                                rec["category"] = category
+                                rec["ts"] = time.time()
+                            existing_recs.append(rec)
+                        except Exception:
+                            pass
+            with open(JOURNAL, "w", encoding="utf-8") as f:
+                for rec in existing_recs:
+                    f.write(json.dumps(rec, ensure_ascii=False) + "\n")
+            load_journal()
+            push_stats()
+            log("ok", f"Bulk recategorized {ok} photos to '{category}'" + (f" ({len(failed)} failed)" if failed else ""))
+            self._json({"ok": True, "updated": ok, "failed": failed})
+
         else:
             self.send_response(404); self.end_headers()
 
 def main():
     n = load_journal()
     load_failures()
+    load_phash_cache()
     print(f"PHOTON console  →  http://localhost:{PORT}")
+    print(f"photo folder    →  {DEFAULT_FOLDER}"
+          + ("  (auto-detected — change it anytime from the Console tab)" if len(sys.argv) <= 1 and not os.environ.get("PHOTON_FOLDER") else ""))
     if n:
         print(f"journal loaded: {n} photos already tagged (will be skipped on resume)")
     ThreadingHTTPServer(("127.0.0.1", PORT), Handler).serve_forever()