Record Browser GIF

•
10
•

Records state-based browser interactions as optimized GIFs and publishes them to dedicated asset branches for pull request visual evidence.

Record Browser GIF automates the capture, deterministic encoding, and hosting of Web UI demonstration GIFs for pull requests and documentation. By orchestrating browser-control tools or headless Playwright, it captures discrete semantic UI states rather than bloated continuous video, compiles frames into lightweight GIFs using Python and FFmpeg, and securely publishes artifacts to dedicated orphan branches without polluting repository history. It enforces an evidence chain by tying recordings to specific commit SHAs and live application runs, ensuring pull request reviewers receive genuine, reproducible visual proof of UI behavior changes.

Key Features

01Detects transient UI states and tool execution lifecycles through DOM marker polling
02Captures discrete, semantic UI states using browser automation locators instead of continuous recording
0310 GitHub stars
04Prevents git repository bloat by publishing visual assets exclusively to isolated orphan branches
05Encodes deterministic, optimized GIFs with custom frame durations, palette mapping, and size limits
06Maintains strict provenance by linking recordings to verified commit SHAs and live runtime environments

Use Cases

01Providing verified visual proof for pull requests that alter user-visible frontend behavior
02Demonstrating end-to-end agentic browser workflows, tool calls, and error-recovery behaviors
03Creating lightweight animated walkthroughs for documentation, release notes, and bug reports