Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

Merge branch 'main' into feat/video-recording

Enzo Biondod6d5fd0fb6da
diff --cc browser_use/browser/profile.py
index 3a748112b,72a53b33a..3c46826f4
--- a/browser_use/browser/profile.py
+++ b/browser_use/browser/profile.py
@@@ -658,22 -594,6 +594,19 @@@ class BrowserProfile(BrowserConnectArgs
# save_har_path: alias of record_har_path
# trace_path: alias of traces_dir
- cookies_file: Path | None = Field(
- default=None, description='File to save cookies to. DEPRECATED, use `storage_state` instead.'
- )
+
- # these shadow the old playwright args on BrowserContextArgs, but it's ok
- # because we handle them ourselves in a watchdog and we no longer use playwright, so they should live in the scope for our own config in BrowserProfile long-term
++ # these shadow the old playwright args on BrowserContextArgs, but it's ok
++ # because we handle them ourselves in a watchdog and we no longer use playwright, so they should live in the scope for our own config in BrowserProfile long-term
+ record_video_dir: Path | None = Field(
+ default=None,
+ description='Directory to save video recordings. If set, a video of the session will be recorded.',
+ validation_alias=AliasChoices('save_recording_path', 'record_video_dir'),
+ )
+ record_video_size: ViewportSize | None = Field(
+ default=None, description='Video frame size. If not set, it will use the viewport size.'
+ )
+ record_video_framerate: int = Field(default=30, description='The framerate to use for the video recording.')
+
# TODO: finish implementing extension support in extensions.py
# extension_ids_to_preinstall: list[str] = Field(
# default_factory=list, description='List of Chrome extension IDs to preinstall.'
diff --cc docs/customize/browser/all-parameters.mdx
index 0f743036b,066b10044..a22495fdc
--- a/docs/customize/browser/all-parameters.mdx
+++ b/docs/customize/browser/all-parameters.mdx
@@@ -85,15 -73,9 +73,11 @@@ mode: "wide
- `screen`: Screen size information, same format as `window_size`
## Recording & Debugging
-- `record_video_dir`: Directory to save video recordings as `.webm` files
+- `record_video_dir`: Directory to save video recordings as `.mp4` files
+- `record_video_size` (default: `ViewportSize`): The frame size (width, height) of the video recording.
+- `record_video_framerate` (default: `30`): The framerate to use for the video recording.
- `record_har_path`: Path to save network trace files as `.har` format
- - `traces_dir`: Directory to save complete Playwright trace files for debugging
+ - `traces_dir`: Directory to save complete trace files for debugging
- `record_har_content` (default: `'embed'`): HAR content mode (`'omit'`, `'embed'`, `'attach'`)
- `record_har_mode` (default: `'full'`): HAR recording mode (`'full'`, `'minimal'`)