mcpField
V
video-lens-gallery

video-lens-gallery

github.com/kar2phiProductivity119448 installsUpdated 6d ago
Repository

About video-lens-gallery

video-lens-gallery manages and browses saved video-lens reports. It rebuilds their index and serves a local gallery for viewing.

Key features

  1. 01Rebuilds the reports index
  2. 02Optional metadata backfill
  3. 03Serves a gallery on localhost

Use cases

  1. 01Organizing saved video analysis reports
  2. 02Browsing reports in a web gallery

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/kar2phi/video-lens --skill video-lens-gallery

After installing, type/video-lens-galleryin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

index.html
scripts/
backfill_meta.py
build_index.py

Details

From the project README

video-lens-gallery

Manage and browse your saved video-lens reports.

Step 1 — Locate skill scripts

Discover both video-lens/scripts ($_sd) and video-lens-gallery/scripts ($_gd) using the standard 8-agent discovery loop:

_sd=$(for d in ~/.agents ~/.claude ~/.copilot ~/.gemini ~/.cursor ~/.windsurf ~/.opencode ~/.codex; do
  [ -d "$d/skills/video-lens/scripts" ] && echo "$d/skills/video-lens/scripts" && break
done)
_gd=$(for d in ~/.agents ~/.claude ~/.copilot ~/.gemini ~/.cursor ~/.windsurf ~/.opencode ~/.codex; do
  [ -d "$d/skills/video-lens-gallery/scripts" ] && echo "$d/skills/video-lens-gallery/scripts" && break
done)
[ -z "$_sd" ] && echo "video-lens skill not found — install it first: npx skills add kar2phi/video-lens" && exit 1
[ -z "$_gd" ] && echo "video-lens-gallery skill not found — install it first: npx skills add kar2phi/video-lens" && exit 1

Step 2 — Backfill metadata (only if requested)

If the user's request mentions "backfill", run:

python3 "$_gd/backfill_meta.py" --dir ~/Downloads/video-lens

Step 3 — Rebuild index

Check that the reports directory exists before running:

[ -d ~/Downloads/video-lens ] || { echo "No reports directory found — save some videos first with the video-lens skill."; exit 1; }
python3 "$_gd/build_index.py" --dir ~/Downloads/video-lens

Tell the user the number of reports indexed, from the script's output.

Step 4 — Serve gallery

bash "$_sd/serve_report.sh" ~/Downloads/video-lens/index.html ~/Downloads/video-lens

If serve_report.sh prints an ERROR: line (e.g. ERROR:SERVE_PORT_BUSY when port 8765 is held by another program), report the message and stop. Otherwise — confirmed by its HTML_REPORT: line — tell the user the gallery is now available at http://localhost:8765/index.html.

Comments

Markdown supported