Skip to content

docs: note computer controls screenshots are faster for webgl #341

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
masnwilliams merged 4 commits into from
May 1, 2026
+8 −0
Merged

docs: note computer controls screenshots are faster for webgl #341

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
bdf6e14
docs: note computer controls screenshots are faster for webgl
masnwilliams Apr 23, 2026
95244f3
Merge branch 'main' into hypeship/docs-screenshot-perf
masnwilliams Apr 30, 2026
a592875
Merge branch 'main' into hypeship/docs-screenshot-perf
masnwilliams May 1, 2026
9894264
Merge branch 'main' into hypeship/docs-screenshot-perf
masnwilliams May 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions browsers/computer-controls.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -158,6 +158,10 @@ kernel browsers computer move-mouse <session id> --x 500 --y 300 --smooth=false

Capture a full-screen PNG or a specific region.

<Tip>
For WebGL and other animation-heavy pages, `captureScreenshot` is noticeably faster than CDP's `Page.captureScreenshot`. If you're driving a computer-use loop off screenshots, prefer computer controls. [GPU acceleration](/browsers/gpu-acceleration) gives an additional small speedup for computer controls screenshots, but does not speed up CDP screenshots.
</Tip>

<CodeGroup>
```typescript Typescript/Javascript
import fs from 'fs';
Expand Down
4 changes: 4 additions & 0 deletions browsers/gpu-acceleration.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,10 @@ GPU acceleration is useful for:
- Video processing and playback
- Canvas-heavy applications

<Note>
GPU acceleration speeds up page rendering, not screenshot capture. CDP's `Page.captureScreenshot` latency is unaffected by GPU. [Computer controls screenshots](/browsers/computer-controls#take-screenshots) see a small speedup with GPU enabled.
</Note>
Copy link
Copy Markdown

@cursor cursor Bot May 1, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Documents Chromium CDP behavior as product spec

Low Severity

The statement "CDP's Page.captureScreenshot latency is unaffected by GPU" documents a Chromium internal behavior as a product-level fact. This violates the rule to keep feature descriptions at the product level rather than describing what Chromium does under the hood — this behavior could change across Chromium versions. The guidance in computer-controls.mdx similarly characterizes CDP screenshot internals. Both notes can convey the same user guidance (prefer computer controls for screenshot-heavy loops) without asserting specifics about CDP's internal capture path.

Additional Locations (1)
Fix in Cursor Fix in Web

Triggered by learned rule: Don't document Chromium internals as product specs

Reviewed by Cursor Bugbot for commit 9894264. Configure here.


## Availability

GPU acceleration is available on [Start-Up and Enterprise plans](https://kernel.sh/pricing). Due to limited capacity during the research preview, GPU-enabled browsers may not always be available.
Loading