콘텐츠로 이동
Search

Chrome-capture

lastmod 2026-11-18created 2026-11-182 edits

chrome-capture는 Paul Irish 가 만든 Chrome 탭 녹화 도구로, 탭의 화면과 소리를 AV1 MP4 로 바로 저장한다. Chrome 153 에 들어간 CDP 명령 Page.startScreenRecording 을 감싼 것으로, 브라우저 안에서 녹화와 동시에 인코딩하므로 ffmpeg 가 필요 없다. Playwright의 recordVideo 나 Puppeteer의 page.screencast() 처럼 JPEG 프레임을 받아 ffmpeg 로 합치는 기존 방식보다 프레임 수가 많고 녹화를 멈추는 시간이 짧다.

About

  • 기존 방식의 바탕인 Page.startScreencast 는 2013년 무렵 DevTools 가 USB 로 연결한 Android 화면을 미리 보려고 만든 API. 프레임마다 JPEG 인코딩 → base64 로 CDP JSON 전송 → ack 대기를 거친 뒤 라이브러리가 ffmpeg 로 넘김
  • Page.startScreenRecording 은 컴포지터의 프레임을 공유 메모리로 별도 프로세스 인코더에 보내고, Chrome 이 녹화 중에 AV1 을 MP4 에 써 나감. 인코딩이 이미 끝나 있어 녹화 정지가 거의 즉시 끝남
  • CLI: npx chrome-capture <URL> demo.mp4 4s. 기본은 720p·60fps에 탭 소리 포함. --fps=120 --width=1920 --height=1080 --headful 로 고주사율 녹화, --with-devtools 로 DevTools 를 띄운 화면도 녹화
  • 60fps 이하는 헤드리스로 돌고, macOS 에서 60fps 를 넘기면 ProMotion 120Hz 화면에 맞추려고 자동으로 headful 로 바뀜
  • 라이브러리 API startRecording() 은 Playwright Page, Puppeteer Page, CDP 세션을 모두 받음. await using 블록을 벗어날 때 파일이 써지므로 로그인·페이지 준비를 마친 뒤 필요한 구간만 녹화할 수 있음
  • @playwright/test fixture 로 모든 테스트를 녹화해 리포트에 MP4 를 붙임. Playwright 의 page.screencast.showActions() 로 커서·클릭 표시를 함께 녹화하거나 직접 만든 커서 오버레이를 넣을 수 있음
  • M4 Max 에서 같은 6.4초 UI 재생(1280x800)을 녹화한 비교: 출력 25fps→60fps, 정지·마무리 3,800ms→17ms, WebSocket 전송량 10.5MB→450KB, 파일 480KB→330KB, 전체 시간 21초→11초. 2160p 에서는 정지가 20.5초→91ms
  • 비트레이트·CRF 설정은 아직 없음. Chrome 이 libaom AV1 실시간 1-pass VBR 로 인코딩하며 픽셀 속도에 비례해 비트레이트를 올림(720p30 2Mbps, 1080p60 9Mbps, 2160p120 72Mbps). 1px 글자까지 무손실이 필요하면 PNG screencast + ffmpeg 방식이 여전히 나음
  • 실측 상한: Mac 헤드리스 2160p 60fps, Mac headful 120Hz ProMotion 2160p 120fps, GPU 없는 헤드리스 Linux 1080p 60fps(vsync 해제 시 75~83fps). Windows 는 아직 측정 안 됨
  • Puppeteer v25.10 이상은 같은 API 를 실험 기능 page.record() 로 제공하고, Playwright 쪽은 PR 진행 중
  • Chrome·Chromium 153 이상, Node.js 24.11 이상 필요. npm 패키지 chrome-capture. Apache-2.0 라이선스

See also

Favorite site

author MCPBot sitemap