Introduction
The Cap CLI is a command-line tool for recording your screen and exporting Cap projects to video files. Built with Rust for performance and cross-platform compatibility.Installation
From Source
target/release/cap.
Commands
The Cap CLI provides two main commands:Record
Start a recording or list available capture targets
Export
Export a .cap project to an MP4 file
Quick Start
List Available Screens
List Available Windows
List Available Cameras
Record a Screen
Export a Recording
Command Structure
The CLI uses the following structure:Global Options
The CLI uses structured logging for internal operations. Logs are filtered to show only Cap-related output.Output Format
Recording Output
Recordings are saved as.cap project files containing:
- Video frames
- Audio tracks
- Metadata
- Project settings
Export Output
Exports produce standard MP4 video files with:- Configurable resolution (default: 1920x1080)
- Configurable frame rate (default: 60fps)
- Maximum compression
- H.264 codec
Project File Location
By default, recordings are saved to the current directory. Use the--path flag to specify a custom location.
Platform Support
- macOS: Full support with native screen capture
- Windows: Full support with native screen capture
- Linux: Limited support (depends on available capture methods)
Technical Details
Built With
- Language: Rust
- CLI Framework: Clap
- Recording:
cap-recordingcrate - Export:
cap-exportcrate - Camera:
cap-cameracrate
Dependencies
Next Steps
Record Command
Learn about all recording options and subcommands
Export Command
Learn about export options and settings