Upload README.md

README.md

@@ -0,0 +1,89 @@
+---
+title: Pocket Video Trimmer
+tags:
+  - video
+  - video-editing
+  - browser
+  - offline
+  - no-install
+---
+
+# Pocket Video Trimmer
+
+A whole video trimmer in **one HTML file**. Download it, double-click it, drop in a video. No install, no upload, no internet.
+
+<!-- ![screenshot](docs/screenshot.png) -->
+
+
+---
+
+## Inputs
+
+Anything the browser can play:
+
+| Works | Usually won't |
+|---|---|
+| MP4 / H.264 · MOV · WebM · most MKV | AVI · exotic codecs |
+
+Any resolution or aspect ratio, portrait or landscape.
+
+---
+
+## Quick start
+
+1. Download `Nugget Video Trimmer vX.X.html`
+2. Double-click to open it in **Chrome or Edge**
+3. Drag a video onto the page
+
+Everything runs inside the browser tab. Nothing is uploaded — the file makes **zero network requests**.
+
+---
+
+## What it does
+
+**Trim** — scrub a filmstrip timeline, drag in/out handles, step frame by frame, or type exact times. A slim bar under the timeline slides the whole selection without changing its length.
+
+**Multi-clip** — queue several cuts from one video and export them all at once into a folder you choose.
+
+**Crop** — draggable box with ratio presets (16:9, 9:16, 1:1, 4:5, 2:3, 21:9, custom…).
+
+**Resize & frame rate** — percentage presets or exact pixels; any fps.
+
+**Compression** — one slider, smaller file ↔ bigger file, with a live size estimate.
+
+**Pictures** — single-frame snapshot, animated GIF, and two kinds of contact sheet:
+- *Auto storyboard* — N×N frames spread evenly across the selection
+- *Manual storyboard* — pick the exact frames yourself, with thumbnails
+
+<!-- ![storyboard example](docs/storyboard.png) -->
+
+---
+
+## Outputs
+
+| | Format |
+|---|---|
+| Video | MP4 (H.264 + AAC), WebM fallback |
+| Pictures | PNG |
+| Animation | GIF |
+
+Files are named from the source, timestamp and settings, e.g. `holiday_1m37s_1280x720_30fps.mp4`.
+
+---
+
+## Good to know
+
+- **Export runs in real time** — a 30-second clip takes about 30 seconds. Keep the tab on screen; it pauses if you switch away and resumes when you return.
+- **It re-encodes**, so output isn't bit-identical to the source. The compression slider controls that trade-off.
+- **GIF is 256 colours** and grows quickly — smaller width and 10–15 fps work best.
+- Manual storyboards hold up to 25 frames; grids go to 10 × 10.
+
+---
+
+## Requirements
+
+Chrome or Edge. Firefox mostly works but falls back to WebM. No server, no dependencies, no build step.
+
+---
+
+*by C_Nugget*