obscura/docs

Obscura is an open-source headless browser engine written in Rust. It runs JavaScript through V8, owns its DOM, layout, and paint pipeline, and speaks the Chrome DevTools Protocol for common Puppeteer and Playwright workflows.

The render-enabled release supports screenshots, scroll-aware layout, activity-driven CDP screencasting, and raster PDF export. Obscura is an independent engine rather than a bundled Chromium build, so compatibility and performance should be measured against the pages and automation flows that matter to you.

Quickstart

• Installation
• Your first fetch
• Extract data
• Connect Puppeteer or Playwright

Guides

• Build from source
• Rendering, screenshots, screencasting, and PDF
• Configure stealth and proxies
• Markdown extraction
• Use with Puppeteer
• Use with Playwright
• Use the MCP server
• Use as a Rust library
• Persist cookies and storage
• Intercept and modify requests
• Run in production at scale

Reference

• CLI reference
• Environment variables

Contributing

• Architecture overview
• Adding a CDP method or Web API
• Testing and debugging

Links

• Source: https://github.com/h4ckf0r0day/obscura
• Releases: https://github.com/h4ckf0r0day/obscura/releases
• Issues: https://github.com/h4ckf0r0day/obscura/issues

License: Apache-2.0.