THE BLACKCAT Stills Studio

# THE BLACKCAT Stills Studio

## Purpose

THE BLACKCAT Stills Studio creates curated, gallery-ready still images from video files.

## Code Location

The server code lives in this repo (migrated 2026-07-06, built on `tools/studio_kit.py`):

```text
studios/stills-studio/
```

## Workspace (heavy media, stays outside the repo)

Source videos, generated stills, job folders and manifests remain in the
original workspace, selected via the `STILLS_STUDIO_WORKSPACE` env var:

```text
/Users/pabloscandoglierro/Documents/Codex/2026-05-07/retomemos-este-tema-porque-tengo-varios
```

The batch engine also uses the global skill script
`~/.agents/skills/video-screenshots-hd/scripts/video_screenshots.py`
(override with `VIDEO_SCREENSHOTS_SKILL_SCRIPT`).

## Launch

```bash
scripts/open-stills-studio.command
```

Or manually:

```bash
STILLS_STUDIO_WORKSPACE="/Users/pabloscandoglierro/Documents/Codex/2026-05-07/retomemos-este-tema-porque-tengo-varios" \
  python3 studios/stills-studio/server.py --port 8765
```

Then open `http://127.0.0.1:8765`.

## Safety Notes

- The `/artifact` preview endpoint only serves files inside the workspace.
- All requests are refused unless they come from this machine (kit guard).
- Final gallery outputs should be JPG files under 5 MB each.
- Original local source videos must not be deleted by the workflow.

## Product Notes

- Primary action: `Procesar stills`.
- Advanced controls stay under `Avanzado`.