Screenshots

# Capture full page (auto-resized for Claude Vision)
bdg dom screenshot output.png

# Capture viewport only
bdg dom screenshot visible.jpg --no-full-page

# Full resolution (disable auto-resize)
bdg dom screenshot full-res.png --no-resize

bdg dom screenshot page.png

# Default JPEG quality (90)
bdg dom screenshot page.jpg --format jpeg

# Maximum quality
bdg dom screenshot page.jpg --format jpeg --quality 100

# Lower quality for smaller files
bdg dom screenshot page.jpg --format jpeg --quality 70

# By selector
bdg dom screenshot element.png --selector "#header"

# By index from previous query
bdg dom query "button"
bdg dom screenshot button.png --index 0

# Element with custom format
bdg dom screenshot widget.jpg --selector ".widget" --format jpeg --quality 90

# Scroll to footer and capture viewport
bdg dom screenshot footer.png --scroll "footer"

# Scroll to element and capture it specifically
bdg dom screenshot pricing.png --scroll "#pricing" --selector "#pricing"

# Scroll to element in list
bdg dom screenshot item.png --scroll ".item" --index 5

# On Retina display (DPR 2.0)
bdg dom screenshot page.png

# Automatically sets DPR to 1 before capture
# Result: 1568px max edge, ~1,600 tokens

bdg dom screenshot long-page.png

{
  "path": "/path/to/long-page.png",
  "captureMode": "viewport",
  "fullPageSkipped": {
    "reason": "page_too_tall",
    "originalHeight": 8000,
    "aspectRatio": 6.7
  },
  "warning": "Full page capture skipped: page too tall (6.7:1 aspect ratio). Only viewport captured."
}

# Capture to directory every second
bdg dom screenshot ./frames --follow

# Custom interval (every 2 seconds)
bdg dom screenshot ./frames --follow --interval 2000

# Limit number of frames
bdg dom screenshot ./frames --follow --limit 10

# JPEG format
bdg dom screenshot ./frames --follow --format jpeg

Capturing to ./frames every 1000ms...
Frame 1: 001.png
Frame 2: 002.png
Frame 3: 003.png
...
^C
Captured 15 frames

bdg dom screenshot page.png --json

{
  "version": "0.5.1",
  "success": true,
  "data": {
    "path": "/absolute/path/to/page.png",
    "format": "png",
    "width": 1568,
    "height": 882,
    "size": 245678,
    "fullPage": true,
    "captureMode": "full_page",
    "finalTokens": 1383,
    "resized": true,
    "originalWidth": 1920,
    "originalHeight": 1080,
    "originalTokens": 2073
  }
}

# Header
bdg dom screenshot header.png --selector "header"

# Main content
bdg dom screenshot main.png --selector "main"

# Footer
bdg dom screenshot footer.png --scroll "footer" --selector "footer"

# Start continuous capture
bdg dom screenshot ./recording --follow --interval 500 &
CAPTURE_PID=$!

# Perform interactions
bdg dom fill "#search" "query"
bdg dom click "#submit"

# Stop capture
kill $CAPTURE_PID

# Review frames
ls -l ./recording/

# Capture viewport (typical mobile view)
bdg dom screenshot mobile.png --no-full-page

# Specific elements
bdg dom screenshot nav.png --selector "nav"
bdg dom screenshot content.png --selector "main"

# Need full quality for OCR
bdg dom screenshot text.png --no-resize

# Small elements already under threshold
bdg dom screenshot icon.png --selector ".icon" --no-resize

# Archival purposes
bdg dom screenshot archive.png --no-resize --format png

# Large pages
bdg dom screenshot page.png  # Auto-resizes to ~1,600 tokens

# High-DPI displays
bdg dom screenshot retina.png  # Handles DPR automatically

# Token budget concerns
bdg dom screenshot all.png  # Stays within Claude Vision limits

# Check if auto-resize is enabled
bdg dom screenshot page.png --json | jq '.data.resized'

# Manually enable auto-resize (it's default)
bdg dom screenshot page.png

# Capture viewport only
bdg dom screenshot page.png --no-full-page

# Scroll to element first
bdg dom screenshot element.png --scroll "selector"

# Check if element exists
bdg dom query "selector"

# Verify element has dimensions
bdg dom get "selector" --raw

# Use PNG for text
bdg dom screenshot page.png --format png

# Increase JPEG quality
bdg dom screenshot page.jpg --format jpeg --quality 100

# Disable auto-resize for full quality
bdg dom screenshot page.png --no-resize