screen-recording

Record macOS screen with ffmpeg and AVFoundation audio inputs.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mshuffett/dotfiles --skill screen-recording
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screen-recording
Source: https://github.com/mshuffett/dotfiles/tree/main/agents/skills/screen-recording
Command: npx skills add https://github.com/mshuffett/dotfiles --skill screen-recording

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ffmpeg, and includes references (resource) components.

What problem does it solve?

This Skill simplifies the process of recording your macOS screen using command-line tools, enabling efficient creation of video demos and application captures.

Core Features & Use Cases

  • CLI Screen Recording: Capture your screen directly from the terminal.
  • Customizable Presets: Offers optimized settings for web demos, microphone input, system audio, and high-fidelity archival.
  • Use Case: Record a tutorial for a new software feature, capturing your cursor and clicks for clarity.

Quick Start

Use the screen-recording skill to record your screen with audio.

Frequently Asked Questions about screen-recording

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I record my macOS screen using ffmpeg from the command line?

You can record your macOS screen using ffmpeg by utilizing the AVFoundation capture device. This method allows direct terminal video capture for demos and tutorials, requiring ffmpeg installation and screen recording permissions.

Can I capture system audio and microphone input together during a screen recording?

Yes, you can capture both system audio and microphone input during a screen recording. The tool supports various audio inputs and output configurations to ensure your video captures both screen activity and sound.

What is the best way to create a video demo recording on macOS without a GUI?

The best way to create a video demo recording without a GUI is using a CLI tool like ffmpeg with AVFoundation. It provides customizable presets optimized for web demos and high-fidelity archival captures.

Do I need to grant screen recording permissions to ffmpeg on macOS?

Yes, you need to grant screen recording permissions to ffmpeg on macOS. The command-line video capture relies on AVFoundation, which requires explicit system permissions to record your screen and audio inputs.

Does ffmpeg support high-fidelity archival presets for video capture?

Yes, ffmpeg supports high-fidelity archival presets for video capture. It offers optimized settings for various output configurations, enabling you to record high-quality application captures directly from the terminal.

Why use a CLI approach for screen recording instead of native macOS tools?

A CLI approach for screen recording provides efficient, scriptable video capture directly from the terminal. It allows precise control over ffmpeg output configurations and customizable presets, streamlining the creation of software demos.