dsh-video-player

dsh-video-player

A floating, draggable, resizable video player for DeepSeek Harness (DSH). It mounts a small window over the web UI that plays scene-per-MP4 clips from a Stash-style scene server — propping a video feed beside your chat and paging through clips while you work. The window moves and resizes in real time, like a real PiP video. Stash is the star; other sources are best-effort.

Install

npm install -g pnpm@11                     # the container image ships no pnpm
dsh plugin --profile web add /path/to/dsh-video-player
# restart the web profile (bundle changes apply at boot only):
sh ~/.dsh/dsh-guard/restart-web.sh

Linked installs need an import bridge. dsh plugin add <dir> installs the plugin as a link: symlink, and Node resolves the host module's imports from its realpath (/path/to/dsh-video-player), which sits outside the profile's node_modules. Before installing from a local dir, give it a bridge:

mkdir -p /path/to/dsh-video-player/node_modules/@deepseek-ai
ln -s ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-settings /path/to/dsh-video-player/node_modules/@deepseek-ai/dsh-settings
ln -s ~/.dsh/profiles/web/node_modules/schemastery /path/to/dsh-video-player/node_modules/schemastery

Features

• Floating, resizable window — drag the title bar to move it, drag the bottom-right corner to resize live (min 200×140). Native <video> player with controls (play/pause, scrub, fullscreen, volume). Inputs and buttons in the title bar are excluded from the drag handler, so they stay clickable/typable.
• Stash scene navigation (the star) — ◀ / ▶ step scenes, a number field + Go / Enter jumps anywhere, and a status line shows the exact stream URL. The default server is http://host.docker.internal:9999 with /scene/{no}/stream per clip; it supports Range requests (verified 206 Partial Content), so seeking works.
• Channel dropdown (custom widget) — Stash / Custom link / YouTube / Twitch / Jellyfin. Built as buttons, not a native <select> (which was unreliable in DSH's dark UI). Picking a channel switches the source immediately.
• Link field with auto-detect — paste a YouTube / Twitch / Jellyfin / direct-file link and it auto-picks the channel and plays it (never appends a /scene/N/stream suffix). Enter or the ▶ button plays; paste auto-plays.
• Gear panel (⚙) = window + Stash config only — width, height, opacity, and the Stash base URL (scene server root). Source/channel config deliberately does NOT live here.
• Persisted geometry — position, size, and opacity survive reloads (localStorage).
• Coexists with the pet & themes — it's a separate fixed overlay alongside the DSH pet and dream-skin wallpaper.

Architecture

• Host half (lib/index.js) — registers the dsh-video-player settings namespace (schema: base, channel, url, scene) and serves GET/POST /api/dsh-video-player/config. The POST handler writes through the DSH settings service, so the source config persists in the real settings store (not localStorage).
• Client half (lib/client.js) — self-contained (plain DOM, inject: [], activates immediately). It polls GET /api/dsh-video-player/config (~2.5s) and pushes title-bar changes back with POST, so the floating window and the settings store stay in sync.

Bugs we hit and fixed (the lessons)

• Host export default drops inject. DSH's bundle loader unwraps a module's default export to the bare function, silently discarding inject/name — services then throw cannot get property "webServer" without inject at boot and take the whole app down. Fix: use named exports only (export function apply, export const inject, export const name), exactly like the dsh-pet host bundle.
• A client that declares an inject it never uses hangs. The client once declared inject: ["@deepseek-ai/dsh-client-runtime"] without requiring it, and sat forever in pending (waiting for service: …). Fix: keep the client self-contained with inject: [].
• Host imports don't resolve for link: installs. See the bridge note above.

Roadmap

• Layer control — put the window in front of chat (default), behind it / tuck into the sidebar, or "minimize to sidebar".
• Transparency — window opacity (done: 0.3–1.0 in the gear panel) plus a click-through toggle for when you want to watch but not interact.
• Alarm / "someone walked in" button — one click plays a sound (TBA).
• Scene thumbnail rail — thumbnails for the current scene ± a few, for faster paging.
• Settings-menu card — the dsh-video-player settings namespace is registered; if the generic settings surface doesn't render it as its own section, add a client settings card (like the pet's) so channel/link are editable from Settings → dsh-video-player.
• Stash scene list — probe the server for valid scene numbers and page within the real set instead of ±1.