chrome-capture
Records a Chrome tab at 60-120fps up to 2160p straight to an AV1 MP4 with optional tab audio, without ffmpeg.
At a Glance
chrome-capture CLI and library released under the Apache License 2.0; free to use, modify and distribute.
Engagement
Available On
Alternatives
Listed Nov 2026
About chrome-capture
chrome-capture is an open-source Node tool and library by Paul Irish that records a Chrome tab directly to an AV1 .mp4 file at 60-120fps and up to 2160p, with optional tab audio. It uses Chrome's Page.startScreenRecording CDP method, so no ffmpeg is needed. It ships as a CLI and as a TypeScript API for Playwright, Puppeteer, or raw CDP.
What It Is
chrome-capture is a screen-recording utility for Chrome tabs. The README says Chrome 153+ has a native MP4 tab recorder, and this project wraps it. Frames go from the compositor to an out-of-process encoder, and Chrome writes AV1 into the mp4 as it records, with optional 48kHz stereo Opus audio.
How It Works
The CLI takes a URL, an output filename, and a duration, for example npx chrome-capture <url> demo.mp4 4s. Options include --fps, --width, --height, --headful, and --with-devtools. Audio is recorded by default, and the CLI runs headless for 60fps or lower. On macOS it switches to headful when the frame rate is above 60 so Chrome can use a 120Hz display.
In code, startRecording() accepts a Playwright Page, a Puppeteer Page, or a CDP session. It supports await using, writes to a file or returns a Buffer, and exposes frame rate, max size, capture area, and audio options. A @playwright/test fixture can record every test and attach the mp4 to the report. A lower-level CdpScreenRecorder is available for raw CDP.
Performance Notes
The README's benchmark, run on an M4 Max, compares the older Page.startScreencast plus ffmpeg pipeline with this approach. It reports stop and finalize time of 17ms versus 3,800ms, and much less WebSocket traffic. There is no bitrate or CRF control; Chrome encodes with libaom AV1 in realtime 1-pass VBR, with target bitrate scaling with pixel rate. The README reports 2160p at 120fps on a 120Hz ProMotion Mac in headful mode and 1080p at 60fps on headless Linux. Windows and Linux with a discrete GPU are listed as untested.
Cursor Overlays
Cursor visibility is handled by DOM overlays. Playwright's showActions() draws a cursor and click badges that are captured natively. The repo includes examples for custom cursor styling.
Community Discussions
Be the first to start a conversation about chrome-capture
Share your experience with chrome-capture, ask questions, or help others learn from your insights.
Pricing
Open Source (Apache-2.0)
chrome-capture CLI and library released under the Apache License 2.0; free to use, modify and distribute.
- Record a Chrome tab at 60-120fps (up to 2160p) to AV1 .mp4
- Tab audio support
- No ffmpeg required
- CLI and Playwright/Puppeteer/raw CDP API
- Licensed under Apache-2.0
Capabilities
Key Features
- Records Chrome tabs to AV1 MP4 at 60-120fps
- Up to 2160p resolution
- Optional 48kHz stereo Opus tab audio
- No ffmpeg required
- CLI with fps, size, headful and DevTools options
- Playwright, Puppeteer and raw CDP support
- @playwright/test fixture that attaches recordings to reports
- Start/stop recording at any point
- Output to file or Buffer
- Custom cursor overlay examples
