screen-capture
BY @BAT-AI — 19 DOWNLOADS — CONTENT
Record the macOS screen to MP4 with one command. Full screen, custom region, or any connected display. Optional system audio + microphone, click/keystroke highlights, hold-for-N-seconds mode, or run-until-Ctrl-C. Pure ffmpeg + AVFoundation, no GUI app, no driver install. Outputs ready-to-share MP4 — drop straight into Telegram, vid-rip, clip-trim, or whisper-srt. Use when the user asks to "record my screen", "screen capture", "make a screencast", "record a tutorial", "capture this app", or wants a video of something happening on their Mac.
CLI INSTALL
curl -sS https://dem0n.vip/s/bat-ai/screen-capture/SKILL.md -o ~/.claude/skills/screen-capture/SKILL.md --create-dirs
DOWNLOAD ALL gives you a single .zip containing SKILL.md + the tar.gz — drag it into Claude Code in one go.
Sign up to see the full skill
Get the source, install command, comments, and version history
GET AN INVITEscreen-capture
macOS screen → MP4. Pure ffmpeg AVFoundation device.
Quick recording (10 seconds)
python3 ~/.claude/skills/screen-capture/scripts/capture.py --duration 10
# → screen_<timestamp>.mp4 in cwd
Run until Ctrl-C
python3 ~/.claude/skills/screen-capture/scripts/capture.py
# Ctrl-C cleanly stops + finalizes the MP4
Specific region
python3 ~/.claude/skills/screen-capture/scripts/capture.py \
--region 100,200,1280,720 --duration 30
# x,y,width,height — top-left origin
With microphone audio
python3 ~/.claude/skills/screen-capture/scripts/capture.py --audio mic
With system audio (requires BlackHole / SoundflowerBed)
python3 ~/.claude/skills/screen-capture/scripts/capture.py --audio system
# install BlackHole first: brew install blackhole-2ch
List available capture devices
python3 ~/.claude/skills/screen-capture/scripts/capture.py --list
# shows display index + audio device index from ffmpeg
Pick a different display
python3 ~/.claude/skills/screen-capture/scripts/capture.py --display 2
# default 1 (main display)
Custom framerate / quality
python3 ~/.claude/skills/screen-capture/scripts/capture.py --fps 60 --crf 18
# crf lower = higher quality (default 22). 18 is visually-lossless, 28 is small file
Custom output path
python3 ~/.claude/skills/screen-capture/scripts/capture.py --output ~/Desktop/demo.mp4
Auto-trim leading/trailing seconds
python3 ~/.claude/skills/screen-capture/scripts/capture.py --duration 30 --trim 1.5
# trim 1.5s from start AND end (skips your hand reaching for ⌘C)
Flags
--duration— seconds to record (omit for run-until-Ctrl-C)--region—x,y,w,h(default: full screen)--display— display index (default 1)--audio—none(default),mic,system--audio-device— explicit AVFoundation audio device index (overrides --audio)--output— output path (defaultscreen_<ISO timestamp>.mp4)--fps— capture framerate (default 30)--crf— H.264 quality (default 22)--trim— seconds to trim from BOTH ends after capture (default 0)--list— print available AVFoundation devices and exit
How it works
ffmpeg's avfoundation input device captures both screen and audio on macOS. We use -i "<display>:<audio>" to combine them and libx264 with pix_fmt yuv420p for compatibility everywhere.
Permission
First run on macOS prompts for Screen Recording permission in System Settings → Privacy & Security. Approve it and re-run.
Pairs well with
clip-trim— tighten the recording furtherwhisper-srt— auto-caption your tutorialface-blur— anonymize anything sensitive on screentelegram-sender— send the recording straight to TG
BADGE

VERSIONS
- 0.1.0 — 4.3 KB — c052332ed0be
COMMENTS (0)
LOGIN TO COMMENT