deps-setup

Files (1)

• SKILL.md

SKILL.md (first lines)

# Deps Setup

Optional installer for third-party video-editing tools. The user picks a subset; each is installed using its native ecosystem's tooling and recorded in `preferences.json` so other skills (and future skills) can find it.

Python-based tools share a single `uv`-managed virtualenv at:

```
${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/video-editing/venv
```

The venv path is stored as `preferences.python_venv` so it can be sourced later (e.g. `"$PYTHON_VENV/bin/python" -m moviepy ...`).

## Tools

| Tool | Repo | Type | Install |
|------|------|------|---------|
| moviepy | https://github.com/Zulko/moviepy | Python (PyPI) | `uv pip install moviepy` |
| auto-editor | https://github.com/WyattBlue/auto-editor | Python (PyPI) | `uv pip install auto-editor` |
| video-use | https://github.com/browser-use/video-use | Python (git) | `uv pip install git+https://github.com/browser-use/video-use` |
| VideoAgent | https://github.com/HKUDS/VideoAgent | Python (git, research) | `git clone` + `uv pip install -r requirements.txt` |
| vit | https://github.com/LucasHJin/vit | Python (git) | `git clone` + `uv pip install -r requirements.txt` |
| faster-whisper | https://github.com/SYSTRAN/faster-whisper | Python (PyPI) | `uv pip install faster-whisper` |
| demucs | https://github.com/facebookresearch/demucs | Python (PyPI) | `uv pip install demucs` |
| LosslessCut | https://github.com/mifi/lossless-cut | Electron app | flatpak: `no.mifi.losslesscut` (fallback: AppImage) |
| editly | https://github.com/mifi/editly | Node.js | `npm install -g editly` (warn: needs Cairo + ffmpeg) |
| whisper.cpp | https://github.com/ggerganov/whisper.cpp | C++ binary | manual — clone, `make`, download GGML model. Record binary + model paths in preferences via `onboard`. |
| exiftool | https://exiftool.org | Perl CLI (apt) | `sudo apt install -y libimage-exiftool-perl` — uniform metadata reader for both images and video (Width / Height / Rotation), useful when ffprobe's CSV output needs sanitising. |
| mediainfo | https://mediaarea.net/en/MediaInfo | C++ CLI (apt) | `sudo apt install -y mediainfo` — reports `DisplayAspectRatio` and `Rotation` post-correction; ideal when you want the *displayed* aspect rather than raw stream dims. |

## Procedure

### 1. Resolve config

```bash
DATA_DIR="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/video-editing"
PREFS_FILE="$DATA_DIR/preferences.json"
TOOLS_DIR="$DATA_DIR/tools"
VENV_DIR="$DATA_DIR/venv"
mkdir -p "$DATA_DIR" "$TOOLS_DIR"
test -f "$PREFS_FILE" || echo '{}' > "$PREFS_FILE"
```

### 2. Bootstrap `uv` (if any Python tool selected)

```bash
if ! command -v uv >/dev/null; then
  echo "uv not installed. Run: curl -LsSf https://astral.sh/uv/install.sh | sh"
  # Ask user before running. Don't silently curl|sh.
fi
```

Confirm with the user before running the install script.

### 3. Create the shared venv (lazy)

```bash
if [ ! -d "$VENV_DIR" ]; then
  uv venv "$VENV_DIR"
fi
```

### 4. Ask the user which to install

Multi-select. Show each tool's purpose in one line:

- **moviepy** — Python video editing library (programmatic clip ops)
- **auto-editor** — auto-cut silences and dead air from video
- **video-use** — agentic video understanding from browser-use
- **VideoAgent** — research multi-agent video understanding (HKU)
- **vit** — video transformer toolkit (LucasHJin)
- **faster-whisper** — fast CPU/GPU whisper inference (used by `burn-subtitles`, `karaoke-video`)
- **demucs** — Facebook Research stem separation (used by `karaoke-video`)
- **LosslessCut** — GUI for fast lossless trim/cut
- **editly** — declarative JSON → video composition (Node)
- **whisper.cpp** — alternative pure-C++ whisper backend (manual install, see notes)
- **exiftool** — uniform metadata reader for both images and video (`sudo apt install -y libimage-exiftool-perl`). Single tool covers `ImageWidth`, `ImageHeight`, `Rotation`, EXIF on JPEG/HEIC/DNG/WEBP/MP4/MOV — useful as a uniform parser when ffprobe's CSV output is fragile.
- **mediainfo** — purpose-built media-inspection CLI (`sudo apt install -y mediainfo`). Reports `DisplayAspectRatio` and `Rotation` already corrected for what the player would show; cleanest single source of truth for video orientation.

### 5. Install per selection

For each chosen tool, **show the exact command first**, ask for confirmation, run, capture exit status.

#### Python (PyPI)

```bash
uv pip install --python "$VENV_DIR/bin/python" moviepy
```

#### Python (git clone + requirements)

```bash
git clone https://github.com/HKUDS/VideoAgent "$TOOLS_DIR/VideoAgent"
uv pip install --python "$VENV_DIR/bin/python" -r "$TOOLS_DIR/VideoAgent/requirements.txt"
```

#### LosslessCut (flatpak)

```bash
if command -v flatpak >/dev/null; then
  flatpak install -y --user flathub no.mifi.losslesscut
else
  echo "flatpak missing — fall back to AppImage download from GitHub releases"
fi
```

#### editly (npm)

```bash
if ! command -v npm >/dev/null; then
  echo "Node.js not installed. Install Node first (see nodejs.org)."
  # Don't auto-install Node — too invasive for a video plugin.
fi
npm install -g editly
```

#### exiftool / mediainfo (apt)

```bash
sudo apt install -y libimage-exiftool-perl mediainfo

From danielrosehill/Claude-Video-Editor-Plugin, MIT.

More from danielrosehill/Claude-Video-Editor-Plugin