retold-remote 0.0.23 → 0.0.26

package/css/retold-remote.css

@@ -1011,6 +1011,262 @@ html, body
 	}
 }
 
+/* ============================================================
+   Gallery — loading & progressive render
+   ============================================================ */
+
+.retold-remote-gallery-loading
+{
+	display: flex;
+	flex-direction: column;
+	align-items: center;
+	justify-content: center;
+	min-height: 240px;
+	padding: 48px 16px;
+	color: var(--retold-text-secondary, #9cdcfe);
+	gap: 12px;
+	text-align: center;
+}
+.retold-remote-gallery-loading-spinner
+{
+	width: 40px;
+	height: 40px;
+	border-radius: 50%;
+	border: 3px solid var(--retold-border, #3c3c3c);
+	border-top-color: var(--retold-accent, #569cd6);
+	animation: retold-spin 0.9s linear infinite;
+}
+.retold-remote-gallery-loading-text
+{
+	font-size: 0.95rem;
+	color: var(--retold-text-primary, #d4d4d4);
+}
+.retold-remote-gallery-loading-path
+{
+	font-size: 0.78rem;
+	color: var(--retold-text-dim, #808080);
+	max-width: 80%;
+	word-break: break-all;
+	font-family: var(--retold-font-mono, monospace);
+}
+
+.retold-remote-gallery-progress
+{
+	position: sticky;
+	bottom: 0;
+	left: 0;
+	right: 0;
+	display: flex;
+	align-items: center;
+	gap: 10px;
+	padding: 8px 14px;
+	background: var(--retold-bg-secondary, #252526);
+	border-top: 1px solid var(--retold-border, #3c3c3c);
+	color: var(--retold-text-dim, #9cdcfe);
+	font-size: 0.78rem;
+	z-index: 10;
+}
+.retold-remote-gallery-progress-spinner
+{
+	display: inline-block;
+	width: 14px;
+	height: 14px;
+	border-radius: 50%;
+	border: 2px solid var(--retold-border, #3c3c3c);
+	border-top-color: var(--retold-accent, #569cd6);
+	animation: retold-spin 0.8s linear infinite;
+	flex-shrink: 0;
+}
+.retold-remote-gallery-progress-text
+{
+	font-family: var(--retold-font-mono, monospace);
+}
+
+@keyframes retold-spin
+{
+	from { transform: rotate(0deg); }
+	to   { transform: rotate(360deg); }
+}
+
+/* Sidebar file browser — loading row */
+.retold-remote-filebrowser-loading-row
+{
+	display: flex;
+	align-items: center;
+	gap: 8px;
+	padding: 10px 14px;
+	color: var(--retold-text-dim, #808080);
+	font-size: 0.8rem;
+	font-style: italic;
+}
+
+/* ============================================================
+   Operation Status — sticky bottom strip for long-running ops
+   (server-side work like DZI generation, video frame extraction,
+   collection export, document conversion, etc.)
+   ============================================================ */
+.retold-remote-operation-status
+{
+	position: fixed;
+	bottom: 0;
+	left: 0;
+	right: 0;
+	z-index: 100;
+	pointer-events: none;
+	display: none;
+}
+.retold-remote-operation-status.has-ops
+{
+	display: block;
+	pointer-events: auto;
+}
+.retold-remote-operation-status-list
+{
+	display: flex;
+	flex-direction: column;
+	gap: 1px;
+	background: var(--retold-bg-secondary, #252526);
+	border-top: 1px solid var(--retold-border, #3c3c3c);
+	box-shadow: 0 -2px 12px rgba(0, 0, 0, 0.25);
+	max-height: 40vh;
+	overflow-y: auto;
+}
+.retold-remote-operation-status-item
+{
+	display: flex;
+	align-items: center;
+	gap: 12px;
+	padding: 10px 16px;
+	background: var(--retold-bg-secondary, #252526);
+	color: var(--retold-text-primary, #d4d4d4);
+	font-size: 0.82rem;
+	border-bottom: 1px solid var(--retold-bg-primary, #1e1e1e);
+	transition: background 0.2s;
+}
+.retold-remote-operation-status-item:last-child
+{
+	border-bottom: none;
+}
+.retold-remote-operation-status-item.is-complete
+{
+	color: var(--retold-text-secondary, #9cdcfe);
+	background: rgba(88, 166, 255, 0.05);
+}
+.retold-remote-operation-status-item.is-error
+{
+	color: #f48771;
+	background: rgba(244, 135, 113, 0.08);
+}
+.retold-remote-operation-status-item.is-cancelled
+{
+	color: var(--retold-text-dim, #808080);
+	background: rgba(128, 128, 128, 0.05);
+}
+.retold-remote-operation-status-spinner
+{
+	display: inline-block;
+	width: 14px;
+	height: 14px;
+	border-radius: 50%;
+	border: 2px solid var(--retold-border, #3c3c3c);
+	border-top-color: var(--retold-accent, #569cd6);
+	animation: retold-spin 0.8s linear infinite;
+	flex-shrink: 0;
+}
+.retold-remote-operation-status-check
+{
+	color: var(--retold-accent, #569cd6);
+	font-size: 1.05rem;
+	flex-shrink: 0;
+	width: 14px;
+	text-align: center;
+}
+.retold-remote-operation-status-error-icon
+{
+	font-size: 1.05rem;
+	flex-shrink: 0;
+	width: 14px;
+	text-align: center;
+}
+.retold-remote-operation-status-text
+{
+	flex: 1;
+	min-width: 0;
+	overflow: hidden;
+}
+.retold-remote-operation-status-label
+{
+	font-weight: 500;
+	white-space: nowrap;
+	overflow: hidden;
+	text-overflow: ellipsis;
+}
+.retold-remote-operation-status-phase
+{
+	font-size: 0.74rem;
+	color: var(--retold-text-dim, #9cdcfe);
+	white-space: nowrap;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	margin-top: 1px;
+}
+.retold-remote-operation-status-bar
+{
+	height: 3px;
+	background: var(--retold-border, #3c3c3c);
+	border-radius: 2px;
+	margin-top: 4px;
+	overflow: hidden;
+}
+.retold-remote-operation-status-bar-fill
+{
+	height: 100%;
+	background: var(--retold-accent, #569cd6);
+	transition: width 0.2s ease-out;
+}
+.retold-remote-operation-status-count
+{
+	font-family: var(--retold-font-mono, monospace);
+	font-size: 0.72rem;
+	color: var(--retold-text-dim, #9cdcfe);
+	white-space: nowrap;
+	flex-shrink: 0;
+}
+.retold-remote-operation-status-cancel
+{
+	background: transparent;
+	border: 1px solid var(--retold-border, #3c3c3c);
+	color: var(--retold-text-dim, #9cdcfe);
+	width: 22px;
+	height: 22px;
+	border-radius: 4px;
+	font-size: 1rem;
+	line-height: 1;
+	cursor: pointer;
+	flex-shrink: 0;
+	padding: 0;
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	transition: background 0.15s, color 0.15s, border-color 0.15s;
+}
+.retold-remote-operation-status-cancel:hover
+{
+	background: rgba(244, 135, 113, 0.12);
+	color: #f48771;
+	border-color: #f48771;
+}
+.retold-remote-operation-status-more
+{
+	padding: 6px 16px;
+	font-size: 0.72rem;
+	color: var(--retold-text-dim, #808080);
+	text-align: center;
+	font-style: italic;
+	background: var(--retold-bg-secondary, #252526);
+	border-top: 1px dashed var(--retold-border, #3c3c3c);
+}
+
 /* ============================================================
    Gallery
    ============================================================ */
@@ -2263,26 +2519,7 @@ html, body
 {
 	opacity: 1;
 }
-.retold-remote-image-explore-btn
-{
-	position: absolute;
-	bottom: 16px;
-	right: 16px;
-	background: rgba(40, 44, 52, 0.85);
-	color: #abb2bf;
-	border: 1px solid rgba(255, 255, 255, 0.15);
-	padding: 6px 14px;
-	border-radius: 6px;
-	font-size: 0.82rem;
-	cursor: pointer;
-	z-index: 20;
-	transition: background 0.2s, color 0.2s;
-}
-.retold-remote-image-explore-btn:hover
-{
-	background: rgba(97, 175, 239, 0.3);
-	color: #fff;
-}
+/* Explore button overlay styles removed — button moved to nav bar */
 .retold-remote-image-large-badge
 {
 	position: absolute;
@@ -2480,6 +2717,75 @@ html, body
 	text-align: center;
 	color: var(--retold-text-secondary);
 }
+/* Subimage region overlays */
+.retold-remote-iex-region-overlay
+{
+	border: 2px solid rgba(229, 192, 123, 0.85);
+	background: rgba(229, 192, 123, 0.08);
+	pointer-events: none;
+	position: relative;
+}
+/* Subimages sidebar panel */
+.retold-remote-subimages-panel
+{
+	overflow-y: auto;
+	height: 100%;
+}
+.retold-remote-subimages-item
+{
+	display: flex;
+	align-items: center;
+	justify-content: space-between;
+	padding: 6px 10px;
+	border-bottom: 1px solid var(--retold-border);
+	cursor: default;
+	transition: background 0.15s;
+}
+.retold-remote-subimages-item:hover
+{
+	background: rgba(255, 255, 255, 0.04);
+}
+.retold-remote-subimages-item-info
+{
+	flex: 1;
+	min-width: 0;
+	overflow: hidden;
+}
+.retold-remote-subimages-item-label
+{
+	font-size: 0.82rem;
+	color: var(--retold-text);
+	white-space: nowrap;
+	overflow: hidden;
+	text-overflow: ellipsis;
+}
+.retold-remote-subimages-item-dims
+{
+	font-size: 0.7rem;
+	color: var(--retold-text-dim);
+	margin-top: 1px;
+}
+.retold-remote-subimages-item-actions
+{
+	display: flex;
+	gap: 2px;
+	margin-left: 6px;
+	flex-shrink: 0;
+}
+.retold-remote-subimages-item-actions button
+{
+	background: transparent;
+	border: 1px solid var(--retold-border);
+	border-radius: 3px;
+	color: var(--retold-text-dim);
+	cursor: pointer;
+	transition: color 0.15s, border-color 0.15s;
+}
+.retold-remote-subimages-item-actions button:hover
+{
+	color: var(--retold-text);
+	border-color: var(--retold-accent);
+}
 
 /* ============================================================
    AudioExplorer
@@ -3515,6 +3821,23 @@ html, body
 	border-color: var(--retold-accent);
 	color: var(--retold-text-primary);
 }
+.retold-remote-collections-export-btn
+{
+	padding: 3px 8px;
+	border: 1px solid var(--retold-border);
+	border-radius: 3px;
+	background: transparent;
+	color: var(--retold-text-muted);
+	font-size: 0.72rem;
+	cursor: pointer;
+	font-family: inherit;
+	margin-left: auto;
+}
+.retold-remote-collections-export-btn:hover
+{
+	border-color: var(--retold-accent);
+	color: var(--retold-text-primary);
+}
 /* ---- Item rows ---- */
 .retold-remote-collection-item
 {

package/docs/README.md

@@ -4,10 +4,18 @@ A browser-based media server and NAS file explorer. Point it at a folder and bro
 
 ## Quick Start
 
+Just the media browser:
+
 ```bash
 npx retold-remote serve /path/to/media
 ```
 
+The full stack (Retold Remote + embedded Orator-Conversion + child Ultravisor):
+
+```bash
+retold-stack /path/to/media
+```
+
 Or with Docker:
 
 ```bash
@@ -17,17 +25,25 @@ docker run -p 8086:8086 -v /path/to/media:/media retold-remote
 
 Then open `http://localhost:8086` in a browser.
 
+See [Stack Launcher](stack-launcher.md) for what `retold-stack` does and how the XDG-style data paths work.
+
 ## Features
 
 - **Gallery browser** with grid and list views, thumbnail generation, and lazy loading
 - **Image viewer** with three fit modes, 0.25x-8x zoom, and EXIF orientation support
 - **Video viewer** with action menu, in-browser playback, VLC streaming, and frame explorer
 - **Audio viewer** with waveform visualization, selection-based playback, and segment extraction
-- **eBook reader** for EPUB and MOBI with table of contents and page navigation
+- **eBook reader** for EPUB and MOBI with table of contents, page navigation, text selection capture, and visual region selection
+- **PDF viewer** with full pdf.js rendering, page navigation, text layer selection, and visual region selection
+- **Document conversion** for DOC, DOCX, RTF, ODT, WPD, ODP, PPT(X), ODS, XLS(X) -- converted to PDF on the fly via Orator-Conversion + LibreOffice
 - **Code/text viewer** with syntax highlighting for 30+ languages
-- **PDF viewer** via native browser rendering
 - **Archive browsing** into zip, 7z, rar, tar.gz, cbz, and cbr files as virtual folders
 - **Filtering and sorting** by media type, extension, file size, date, and text search (with regex)
+- **Subimage regions** -- draw labeled rectangles on images, ebook pages, and PDF pages; persisted per file. Double-click an existing region to resize, move, or rename it in place.
+- **Regions Browser** -- topbar button opens a folder-scoped view of every saved region across every file; drill down by folder tree, click any region to jump to it.
+- **Collections & Export** -- bookmark files, image crops, video clips, audio clips, and document regions; export the whole collection to a folder with proper file cutting
+- **Stack mode** -- single command launches Ultravisor coordinator + Retold Remote + embedded Orator-Conversion with sane XDG data paths
+- **Ultravisor offload** -- heavy work (frame extraction, waveforms, conversions) dispatched to a beacon worker on a faster machine
 - **15 themes** from greyscale to retro and cyberpunk
 - **Full keyboard navigation** across every mode
 - **Media type override** to force any file open as image, video, audio, or text (keys 1-4)
@@ -40,14 +56,17 @@ Then open `http://localhost:8086` in a browser.
 | Document | Contents |
 |----------|----------|
 | [Server Setup and Docker](server-setup.md) | Installation, CLI options, environment variables, configuration, Docker |
+| [Stack Launcher](stack-launcher.md) | `retold-stack` and `--stack` flag, XDG paths, child process orchestration |
+| [Synology Container Manager](synology.md) | Run the full stack on a Synology NAS via Container Manager |
+| [Ultravisor Integration](ultravisor-integration.md) | Offloading heavy media processing to a beacon worker |
 | [Image Viewer](image-viewer.md) | Fit modes, zoom, keyboard shortcuts, mouse interactions |
 | [Video Viewer](video-viewer.md) | Action menu, in-browser playback, VLC streaming |
 | [Audio Viewer](audio-viewer.md) | HTML5 playback, autoplay, VLC streaming |
-| [eBook Reader](ebook-reader.md) | EPUB/MOBI support, table of contents, page navigation |
-| [Image Explorer](image-explorer.md) | Deep-zoom with OpenSeadragon, DZI tiling, coordinate display |
+| [eBook Reader](ebook-reader.md) | EPUB/MOBI support, TOC, page nav, text/region selection |
+| [Image Explorer](image-explorer.md) | Deep-zoom with OpenSeadragon, DZI tiling, region selection |
 | [Video Explorer](video-explorer.md) | Frame grid, timeline, range selection, clip extraction |
 | [Audio Explorer](audio-explorer.md) | Waveform visualization, selection, zoom, segment playback |
-| [Collections](collections.md) | Bookmarks, favorites, quick-add, item types, operation plans |
+| [Collections](collections.md) | Bookmarks, favorites, quick-add, item types, operation plans, export |
 | [File Metadata](metadata.md) | Info overlay, sidebar metadata, EXIF/GPS, ffprobe, explorer info bars |
 
 ## Keyboard Shortcuts (All Modes)
@@ -158,10 +177,24 @@ In the frame preview overlay:
 | `+` / `=` | Zoom in |
 | `-` | Zoom out |
 | `0` | Reset zoom |
-| `a` | Quick-add to collection |
+| `s` | Toggle region selection mode (draw rectangles) |
+| Double-click a region | Enter edit mode (resize, move, rename) |
+| `a` | Quick-add to collection (current region if selected) |
 | `b` | Toggle collection panel |
 | `h` | Toggle favorite |
-| `Esc` | Back to viewer |
+| `Esc` | Unwind one layer (edit mode -> selection mode -> back to viewer) |
+
+### Document Viewer (PDF / EPUB)
+
+| Key | Action |
+|-----|--------|
+| `s` | Toggle visual region selection mode |
+| `a` | Quick-add document region to collection |
+| `Esc` | Back to gallery |
+
+In the PDF viewer, page navigation buttons and a page input are in the controls bar. The text layer supports native browser text selection -- use the **Save Selection** button to capture selected text as a labeled region.
+
+In the EPUB reader, the controls bar exposes **Save Selection** (captures the selected text + CFI) and **Select Region** (draws a rectangle over the rendered page).
 
 ### Sidebar (F9)
 
@@ -184,7 +217,9 @@ mp4, webm, mov, mkv, avi, wmv, flv, m4v, ogv, mpg, mpeg, mpe, mpv, m2v, ts, mts,
 mp3, wav, ogg, flac, aac, m4a, wma, oga
 
 ### Documents
-pdf, epub, mobi
+pdf, epub, mobi, doc, docx, rtf, odt, wpd, wps, pages, odp, ppt, pptx, ods, xls, xlsx
+
+Documents beyond pdf/epub/mobi are converted to PDF on the fly via the embedded Orator-Conversion service (requires LibreOffice or Calibre on the server).
 
 ### Archives
 zip, 7z, rar, tar, tar.gz, tar.bz2, tar.xz, tgz, cbz, cbr
@@ -204,13 +239,16 @@ These external tools enhance functionality when available on the server:
 
 | Tool | Feature |
 |------|---------|
-| **sharp** (npm) | Fast image thumbnail generation |
+| **sharp** (npm) | Fast image thumbnail generation, region cropping |
 | **ImageMagick** | Fallback image thumbnails |
-| **ffmpeg** | Video thumbnails, frame extraction, audio waveforms |
+| **ffmpeg** | Video thumbnails, frame extraction, audio waveforms, clip cutting |
 | **ffprobe** | Media metadata (duration, resolution, codec) |
 | **7-Zip** (7z) | Archive browsing for rar, 7z, tar.* formats |
 | **VLC** | External video streaming |
-| **ebook-convert** (Calibre) | MOBI to EPUB conversion |
+| **audiowaveform** (BBC) | Faster audio waveform peak generation |
+| **ebook-convert** (Calibre) | MOBI/AZW to EPUB conversion (and PDF fallback for documents) |
+| **LibreOffice** (`soffice`) | DOC/DOCX/RTF/ODT/WPD/PPT(X)/XLS(X) to PDF conversion |
+| **pdftk** + **pdftoppm** (poppler) | PDF page extraction and rendering (used by Orator-Conversion) |
 
 Without these tools the application still works -- images serve directly, videos play in-browser, and zip/cbz archives use native extraction.
 
@@ -231,7 +269,21 @@ Without these tools the application still works -- images serve directly, videos
 | GET | `/api/media/audio-waveform?path=&peaks=` | Audio waveform peak data |
 | GET | `/api/media/audio-segment?path=&start=&end=` | Extract audio segment |
 | GET | `/api/media/ebook-convert?path=` | Convert MOBI to EPUB |
-| GET | `/api/media/ebook/:cacheKey/:filename` | Serve converted ebook |
+| GET | `/api/media/doc-convert?path=` | Convert DOC/DOCX/RTF/ODT/WPD/etc. to PDF |
+| GET | `/api/media/ebook/:cacheKey/:filename` | Serve converted ebook or PDF |
+| GET | `/api/media/pdf-text?path=&page=` | Extract text from a PDF page |
+| GET | `/api/media/subimage-regions?path=` | List labeled regions for a single file |
+| GET | `/api/media/subimage-regions?folder=<prefix>` | List labeled regions for every file under a folder prefix (empty prefix = everything). Backed by an in-memory cache invalidated on mutations. |
+| POST | `/api/media/subimage-regions` | Add a labeled region (visual or text-selection) |
+| PUT | `/api/media/subimage-regions/:id` | Update a region's label or coordinates |
+| DELETE | `/api/media/subimage-regions/:id?path=` | Remove a labeled region |
+| GET | `/api/collections` | List all collections |
+| POST | `/api/collections/:guid/items` | Add items to a collection |
+| POST | `/api/collections/:guid/export` | Export collection to a folder (cuts clips, crops images) |
+| POST | `/api/conversion/1.0/doc-to-pdf` | Convert any document buffer to PDF (via Orator-Conversion) |
+| POST | `/api/conversion/1.0/pdf-to-page-png/:Page` | Render a PDF page as PNG |
+| POST | `/api/conversion/1.0/pdf-to-page-jpg/:Page/:LongSidePixels` | Render and resize a PDF page as JPEG |
+| POST | `/api/conversion/1.0/image/resize` | Resize an image |
 | POST | `/api/media/open` | Open file in external player (VLC) |
 
 ## License

package/docs/_cover.md

@@ -1,14 +1,14 @@
-# Retold Remote <small>Documentation</small>
+# Retold Remote
 
 > A browser-based media server and NAS file explorer
 
 Browse images, videos, audio, ebooks, code, and documents through a keyboard-driven gallery interface with 15 built-in themes. Point it at a folder and start exploring.
 
-- **Gallery Browser** — Grid and list views with thumbnails, filtering, sorting, and text search
-- **Media Viewers** — Dedicated viewers for images, video, audio, ebooks, code, and PDFs
-- **Video Explorer** — Extract and browse frames from any video with a visual timeline
-- **Audio Explorer** — Waveform visualization with selection, zoom, and segment playback
-- **Full Keyboard Navigation** — Every feature accessible from the keyboard
+- **Gallery Browser** -- Grid and list views with thumbnails, filtering, sorting, and text search
+- **Media Viewers** -- Dedicated viewers for images, video, audio, ebooks, code, and PDFs
+- **Video Explorer** -- Extract and browse frames from any video with a visual timeline
+- **Audio Explorer** -- Waveform visualization with selection, zoom, and segment playback
+- **Full Keyboard Navigation** -- Every feature accessible from the keyboard
 
 [Get Started](server-setup.md)
 [View on GitHub](https://github.com/stevenvelozo/retold-remote)

package/docs/_sidebar.md

@@ -2,6 +2,8 @@
 
 - Getting Started
   - [Server Setup & Docker](server-setup.md)
+  - [Stack Launcher](stack-launcher.md)
+  - [Synology Container Manager](synology.md)
   - [Ultravisor Integration](ultravisor-integration.md)
   - [Ultravisor Beacon Tool Setup](ultravisor-configuration.md)
 

package/docs/_topbar.md

@@ -1,3 +1,3 @@
-# Retold Remote <small>docs</small>
+# Retold Remote
 
 - [Back to App](/)

package/docs/_version.json

@@ -0,0 +1,7 @@
+{
+	"Name": "retold-remote",
+	"Version": "0.0.25",
+	"Description": "Retold Remote - NAS media browser with gallery views and keyboard navigation",
+	"GeneratedAt": "2026-04-10T17:27:56.648Z",
+	"GitCommit": "bead262"
+}

package/docs/collections.md

@@ -16,6 +16,11 @@ Press `a` in any mode to add the current item to a collection. If a collection i
 | Video explorer | Video frame | Path, timestamp, cached frame image |
 | Video explorer (with selection) | Video clip | Path, start time, end time |
 | Audio explorer (with selection) | Audio clip | Path, start time, end time |
+| Image explorer (with active region) | Image crop | Path, X, Y, Width, Height in original pixels |
+| PDF viewer (with text selection) | Document region (text) | Path, page number, selected text |
+| PDF viewer (with visual region) | Document region (visual) | Path, page number, X/Y/Width/Height in PDF units |
+| EPUB reader (with text selection) | Document region (text) | Path, CFI, spine index, chapter title, selected text |
+| EPUB reader (with visual region) | Document region (visual) | Path, X/Y/Width/Height in container coordinates |
 
 ### Folder Choice
 
@@ -136,11 +141,35 @@ Pending item destinations can be edited inline by clicking the destination path.
 | `a` | Gallery, viewer, all explorers | Quick-add current item to collection |
 | `s` | Video explorer | Add selected range as video clip |
 | `s` | Audio explorer | Save audio snippet to collection |
+| `s` | Image explorer | Toggle region selection mode |
+| `s` | Document viewer (PDF/EPUB) | Toggle visual region selection mode |
 | `[` | Video explorer | Set selection start at current frame |
 | `]` | Video explorer | Set selection end at current frame |
 | `b` | All modes | Toggle collection panel |
 | `h` | All modes | Toggle favorite |
 
+## Export
+
+Collections can be exported to a folder within the content root. Each item is processed according to its type:
+
+| Item Type | Export Behavior |
+|-----------|----------------|
+| `file` / `subfile` | Copied directly to the destination |
+| `image-crop` | Cropped via sharp at the original resolution |
+| `video-clip` | Extracted via `ffmpeg -ss -t -c copy` |
+| `video-frame` | Extracted via `ffmpeg -ss -vframes 1` |
+| `audio-clip` | Extracted via `ffmpeg -ss -t -vn` |
+| `document-region` (text) | Written as a `.txt` file with the captured text and source metadata |
+| `document-region` (visual) | Metadata file describing the page and region |
+| `folder` | Copied recursively |
+| `folder-contents` | Files copied flat into the destination |
+
+Exported files are named `{sortOrder}_{label}.{ext}` so the order is preserved on disk.
+
+To export, click the **⇩ Export** button in the collection detail header. You will be prompted for a destination path (relative to the content root).
+
+The export endpoint is restricted to paths within the content root for safety -- paths containing `..` or absolute paths are rejected.
+
 ## Data Storage
 
 Collections are stored server-side as Bibliograph records. Each collection is a JSON document containing the collection metadata and its items array. The favorites collection uses a well-known GUID and is created automatically.
@@ -160,3 +189,4 @@ Client-side state (which collection is open, panel width, last-used collection)
 | PUT | `/api/collections/:guid/reorder` | Reorder items (manual sort) |
 | POST | `/api/collections/copy-items` | Copy items between collections |
 | POST | `/api/collections/:guid/execute` | Execute pending operations (operation plans) |
+| POST | `/api/collections/:guid/export` | Export the collection to a folder within the content root |