From beec9269fed768fdb4859f77c5d60938e3322679 Mon Sep 17 00:00:00 2001
From: Mitchell-Johnson <mitchelljoho@gmail.com>
Date: Sun, 11 Oct 2026 16:43:03 -0700
Subject: [PATCH] PLAN.md: video and audio playback in the Files viewer, as the
 file is

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---
 PLAN.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/PLAN.md b/PLAN.md
index 8d50470..ffd1960 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -707,6 +707,26 @@ something long in one, switch away and back, refresh — it's all still there.
     refused outright rather than half-copied. Progress every 500 files or 512 MiB.
     Verified on `grid` ext4 → ZFS with a tree holding a 0600 file, a symlink and an old
     mtime, all intact on the other side.
+- **Video and audio play in the viewer** — **shipped 2026-10-11** (v0.1.0-208). Asked for
+  as "keep it simple for now, and just send whatever codec the file is in to the client,
+  and let the client try to decode and watch it" — and that is the whole design. Opening a
+  video or audio file shows a `<video>`/`<audio>` with the browser's own controls, fed the
+  file as it is by `/api/files/read`; nothing is transcoded or remuxed, so what plays is
+  what the browser decodes (Safari: h264/hevc/aac in mp4/mov; Chrome: those plus vp9/av1 in
+  mkv/webm, hevc only where the machine has a hardware decoder; nothing plays MPEG-TS or a
+  GoPro `.360`'s raw EAC strip). When the element errors the viewer says so and leaves the
+  download. What the server gained is the part a player cannot do without: reads of a
+  real file with a known size go through `http.ServeContent`, so **Range requests** (every
+  seek, and Safari's first request) and HEAD work, and a download can resume. The root
+  backend's helper takes `--offset` for that, and `files.Seeker` opens the backend once, at
+  the range asked for, rather than streaming from the top and skipping; seeking costs
+  nothing until a read wants somewhere else. `/proc` files, which stat at size 0, keep the
+  plain streaming path, as does the editor's capped read. Audio became a preview kind at
+  the same time (`thumbs.Kind` → `audio`): its cover art, where it has any, is the row's
+  thumbnail, with a ♪ badge.
+  - *Not done, on purpose:* no transcoding or HLS for what the browser lacks (that is the
+    opposite of "keep it simple"; Jellyfin exists for it), no playlist or next/previous, no
+    subtitles.
 - **Docker read-only view** — `docker ps`/logs; dockhand stays the source of truth.
 - **Notifications** — push on service failure / SMART warning / UPS event.
 - **Terminal extras** — search, copy-mode, font/theme, split panes, upload via