Capture
bl screencast
Record the page as video (native BiDi screencast)
Record the page as video (native BiDi screencast)
Usage
bl screencast [OPTIONS]
bl screencast <command>Options
| Option | Description |
|---|---|
--headless | Hide browser window (visible by default) |
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
bl screencast start
Start a native video recording of the page viewport
Usage
bl screencast start [OPTIONS]Options
| Option | Description |
|---|---|
--mime-type <value> | Video MIME type, e.g. video/webm (default: browser-chosen) |
--width <value> | Requested video width in pixels (default: browser-chosen) |
--height <value> | Requested video height in pixels (default: browser-chosen) |
--frame-rate <value> | Requested video frame rate in frames per second (default: browser-chosen) |
--audio | Also capture the page's audio |
--headless | Hide browser window (visible by default) |
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl screencast start
# Start recording video with browser defaults
bl screencast start --mime-type video/webm --frame-rate 30
# Request WebM at 30 fps
bl screencast start --width 1280 --height 720 --audio
# Request 720p video with page audiobl screencast stop
Stop the screencast and print the video file path
Usage
bl screencast stop [OPTIONS]Options
| Option | Description |
|---|---|
--screencast <value> | Screencast id to stop (default: this session's active screencast) |
-o, --output <value> | Copy the recorded video to this path (the browser-created source file is kept) |
--headless | Hide browser window (visible by default) |
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl screencast stop
# Stop and print the browser-written video path
bl screencast stop -o demo.webm
# Stop and copy the video to demo.webm