Add batch screenshot documentation with configuration guide

[Copilot]

Adds comprehensive documentation for the pyrobird screenshot command, which previously lacked usage examples and configuration details.

Documentation Added

• Installation: Playwright setup with chromium binaries
• Command options table: All 6 CLI flags with defaults and descriptions
• Configuration details: Viewport (1920x1080), full-page mode, timeouts, headless Chromium
• Examples:
  • Custom output paths with auto-numbering
  • Specific event URLs
  • Batch processing script template for multiple events
  • Programmatic Python usage
• Troubleshooting: Playwright installation, server startup, incomplete renders, permissions

Example Batch Script

for event in {0..9}; do
    pyrobird screenshot \
        --work-path="$DATA_PATH" \
        --url "http://localhost:5454/#/event?file=local://$DATA_FILE&event=$event" \
        --output-path "event_${event}.png"
done

Screenshots auto-save to screenshots/ directory with numbering to prevent overwrites (event_001.png, event_001_001.png, etc.).

Files Modified

• doc/pyrobird.md: Added batch screenshot section (+217 lines)
• pyrobird/README.md: Added batch screenshot section (+217 lines)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add documentation of how to make batch screenshots</issue_title>
<issue_description>And control their config
</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Add documentation of how to make batch screenshots #69

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

Pull request overview

This PR adds comprehensive documentation for the pyrobird screenshot command, addressing the lack of usage examples and configuration details. The documentation covers installation requirements, command-line options, practical examples including batch processing workflows, configuration defaults, troubleshooting guidance, and programmatic Python usage.

Key Changes

• Added complete documentation section (+217 lines each) covering all aspects of the screenshot command
• Includes practical batch processing examples with shell scripts for automating event visualization
• Documents screenshot configuration (viewport, timeouts, browser settings) and auto-numbering system

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 8 comments.

File	Description
pyrobird/README.md	Added "Batch Screenshots" section with complete usage documentation for the screenshot command
doc/pyrobird.md	Added identical "Batch Screenshots" section to maintain documentation consistency across locations

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[DraTeots]

Merged manually to 2026-02