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 teasers from a master, pulling audio, stitching frames. None of it is creative, and 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, sitting in your Terminal where it can run things.
  • Desktop Commander: the MCP that lets Claude execute commands on your Mac.
  • FFmpeg: the open-source video engine a lot of the software you already use is built on.

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

It won't replace DaVinci, Premiere, FCP, CapCut, or your taste. Think of it as the batch processor that frees those tools for the work that needs taste. Mechanical work goes to Claude and FFmpeg; creative work stays with 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, no editor needed.
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. If FFmpeg can do it, you can ask Claude to do it, 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 whatever 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

FFmpeg isn't the magic here. Any time-eating mechanical work in a creative pipeline can be lifted out and handed to a system. Other domains have other tools. The pattern (automate the mechanical, protect the creative) carries over.


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, that's 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 large 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, the full stack's 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/."

Rough time saved: around 50 minutes of manual work, done in about 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, so 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 and lossless.
  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, the way a 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, ask why it's being run and what it does, and 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 can pay 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 where it belongs, the cut and the color, while the system handles the rest.

The gain here isn't any single tool. It's the separation: knowing which work belongs to FFmpeg, which to your editor, which to you. Once that line is clear, projects move faster and your time goes back where it should be.

Build it once. Keep using it. The first project can pay for the install.