Spectralmoon · The Lab · Setup Manual № 04

The Video Stack

Turn your Mac into a Claude-powered batch processor for everything your AI gens spit out — so your editor stays for the cuts.

30 min
Install time
$20 / mo
Total cost
~10×
Batch speedup
0
Lines of code you write

01Why this exists

Every AI-video workflow has the same hidden tax: the mechanical glue between generation and edit. Re-encoding WebMs into ProRes-friendly MP4s. Watermarking a folder. Cutting fifteen-second teasers from a one-minute master. Generating thumbnails. Stitching frames. Pulling audio out. None of it is creative. All of it eats hours.

If you already work with Claude, you already have the brain. What you're missing is the hands. This manual installs the hands — two free tools that let Claude actually do video work on your Mac instead of just talking about it:

  • Claude Code — the command-line surface of Claude. Same Claude, just sitting in your Terminal where it can run things.
  • Desktop Commander — the MCP that gives Claude permission to execute commands on your Mac.
  • FFmpeg — the open-source video engine behind Chrome, YouTube, Netflix, and most editors' internals.

You type a sentence. Claude figures out the FFmpeg command. Desktop Commander runs it. FFmpeg does the work — fast, lossless, the actual engine YouTube uses. Output lands in a folder you choose. The whole thing collapses the distance between describing a task and the file being done.

It's not a replacement for DaVinci, Premiere, FCP, CapCut, or your taste. It's the batch processor that frees those tools to do the work that needs taste. Mechanical work → Claude + FFmpeg. Creative work → you.

About FFmpeg

Created by Fabrice Bellard in 2000. The name = "Fast Forward" + "MPEG". Supports 100+ codecs. Pipeline beneath every command: input → demultiplex audio/video → decode to frames → process → re-encode → output. When you ask Claude to do video work, Claude is writing FFmpeg commands under the hood. The heavy lifting is FFmpeg's; Claude is the conversational layer on top.

The hard work isn't the AI. It's the spec. Once you can describe what you want with precision, the rest is just plumbing. — Lab Module 8, May 2026

02What you can do after the install

#CapabilityWhat it does
01Batch watermarkDrop a logo on every clip in a folder. One sentence, thirty videos done.
02Format convertWebM / MOV / ProRes / AVI / whatever → whatever your editor needs. Batched.
03Trim + concatenateCut intro/outro, splice clips, restitch a sequence — without opening an editor.
04Compress for platformWhatsApp / IG Stories / YouTube / client preview — all from one source, one pass.
05ThumbnailsPull a frame at any timestamp from a folder of videos. Batch for listings or grids.
06Color filters / LUTsApply a consistent look across a batch via FFmpeg filter chains.
07Speed manipulation2×, 0.5×, reverse, time-lapse — no timeline required.
08AudioReplace track, mix multiple sources, normalize volume across a batch.

Non-exhaustive. Everything FFmpeg can do, you can now ask Claude to do — in plain English.


03The pipeline at a glance

┌─────────────────────────┐    ┌──────────────────────────────┐
│  Stage 01 — Source      │ →  │  Stage 02 — Batch            │
│  iPhone, Lovart,        │    │  (Claude + FFmpeg)           │
│  Higgsfield, Kling,     │    │  Mechanical work             │
│  Nano Banana, Runway    │    │                              │
└─────────────────────────┘    └──────────────────────────────┘
                                          ↓
┌─────────────────────────────┐    ┌──────────────────────────────┐
│  Stage 03 — Creative        │ →  │  Stage 04 — Distribute       │
│  (you + your editor)        │    │  (Claude + FFmpeg)           │
│  Taste, color, the cut      │    │  Format variants per channel │
└─────────────────────────────┘    └──────────────────────────────┘

Stage 02 is what this manual installs — the catch-net for everything your AI gens, your iPhone, your screen recordings, and your downloads produce. Mechanical processing, no editor needed.

Stage 03 stays yours. The cut, the color, the rhythm. DaVinci, Premiere, FCP, CapCut — whichever your hands already know.

Stage 04 is the distribution pass — three sizes, three formats, one source, one command.

The pattern matters more than the tools

The point isn't that FFmpeg is magical. It's that any time-eating mechanical work in a creative pipeline can be lifted out and given to a system. Other domains have other tools. The pattern — automate the mechanical, protect the creative — is universal.


04The install path · five steps, thirty minutes

Open Terminal (Spotlight: Cmd+Space, "Terminal") and run each step in order.

Step 01 — Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

It'll ask for your Mac password (characters don't display — normal). Wait a few minutes. Verify with brew --version.

Step 02 — FFmpeg

brew install ffmpeg

Verify with ffmpeg -version — should report 6.x or later.

Step 03 — Node.js

brew install node

Verify: node --version and npm --version.

Step 04 — Claude Code

npm install -g @anthropic-ai/claude-code

Run claude for first launch. Walks you through Anthropic sign-in. Pro plan ($20/mo) is plenty for this work — only go Max ($100/mo) if you start running multi-hour sessions or batch-processing huge volumes daily.

Step 05 — Desktop Commander

Inside Claude Code:

claude mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander

Restart Claude Code. Done.


05Three tests to confirm it works

In Claude Code, type each prompt in plain English:

Test 01 — Desktop Commander is alive

"What's my Node version? Use Desktop Commander to check."

Should report your Node version.

Test 02 — File system access

"Make a folder at ~/Desktop/ffmpeg-test/ and put a file called hello.txt inside that says 'FFmpeg setup works'."

Open Finder. Check Desktop.

Test 03 — FFmpeg is reachable

"Run ffmpeg -version using Desktop Commander and tell me what version is installed."

If Claude reports a version — full stack confirmed. Move to real work.


06Four workflows you'll use this week

Each is one sentence to Claude. Adapt the file paths to your own projects.

Workflow 01 — Batch watermark a folder

"Take all the .mp4 files in ~/Desktop/Project/ and overlay the watermark from ~/Desktop/watermark.png on the bottom-right at 70% opacity. Save the watermarked versions to ~/Desktop/Project_watermarked/."

Time saved: 5 min per video × 10 videos = ~50 min → ~30 seconds.

Workflow 02 — Convert AI-gen output to editor-friendly format

"Convert all WebM files in ~/Desktop/AI_outputs/ to MP4 with H.264 codec, 30fps, ProRes-friendly, and save them to ~/Desktop/for_editor/."

Use case: Lovart, Higgsfield, Kling, Veo, Runway, Nano Banana — they each export differently. This normalizes the whole batch before you import.

Workflow 03 — Three distribution variants from one master

"Take ~/Desktop/master.mp4 and make three versions — one for WhatsApp (under 16MB, max 1280×720), one for Instagram Stories (1080×1920 vertical), and one full-quality for YouTube. Save them all to ~/Desktop/distribution/."

Three variants, one source, seconds.

Workflow 04 — Batch thumbnails

"Pull a thumbnail at the 5-second mark from every video in ~/Desktop/listings/ and save them as JPGs to ~/Desktop/thumbnails/."

Every video gets a matching thumb. Listings, social posts, web grids.


07Under the hood

The whole stack is local to your Mac. Video files never leave your machine. Anthropic doesn't see your footage. What goes to Claude's servers: the text of your request and what files exist in the folders you point it at — folder listings, not file contents.

The chain:

  1. You type a request in plain English.
  2. Claude figures out which FFmpeg command(s) to run.
  3. Desktop Commander runs them on your Mac, with your permission.
  4. FFmpeg does the actual work — fast, lossless, the same engine powering YouTube and Netflix encode pipelines.
  5. Claude reports back: what happened, where the files landed, what's next.

It's a conversation, not a script. If a command fails, Claude reads the error and tries again — same as a human collaborator would.

On safety

Desktop Commander can run any command on your Mac with your permission. First time Claude proposes something, it'll ask. Get familiar with the prompt. If a command looks unclear — "why this command? what does it do?" — Claude will explain before you approve.


08What it costs

ItemCost
Homebrew, FFmpeg, Node, Desktop CommanderFree
Claude Pro (recommended)$20 / month
Claude Max (only if you scale heavy)$100 / month
Solo creator total$20 / month

The first watermark batch pays for the month.

Closing

Once the stack is live, you stop thinking about the mechanical layer. You stop opening apps for things that should take seconds. Your creative attention goes back to where it belongs — the cut, the moment, the taste — and the system handles the rest.

The leverage isn't from any single tool here. It's from the separation — knowing which work belongs to FFmpeg, which to your editor, which to you. Once that line is clear, every project moves faster, every output is cleaner, and your time goes back where it should be.

Build it once. Use it forever. The first project pays for the install.