GitHub - Vheissu/captura: Free open source screenshot application that gives you screenshotapi.net features in a free Laravel + Node.js app

Captura is a free, open-source, self-hosted screenshot API inspired by screenshotapi.net. It lets you capture screenshots of any public URL via a simple HTTP API without recurring SaaS fees.

Captura captured itself.

Highlights

• Sync, async, and bulk screenshot capture
• PNG, JPG, WebP, and PDF output
• Full-page, viewport, element, or crop-rectangle capture
• HiDPI, mobile, touch, landscape, and transparent-background rendering
• Screen/print CSS media and reduced-motion emulation for steadier captures
• Custom CSS/JS injection, external CSS/JS URLs, and request cookies
• Lazy-load scrolling, scroll-to-element, click-before-capture, and selector redaction/removal
• Cookie banner hiding, ad/tracker/chat blocking, and request/resource blocking
• Built-in caching and webhook notifications
• Stealth mode, proxy support, and region-aware identity presets

Quick start

Prerequisites: Docker + Docker Compose.

docker compose build
docker compose up -d

docker compose run --rm app php artisan migrate

Open the docs page:

• http://localhost/
• http://localhost/docs

API endpoints

• GET /health
• GET|POST /api/screenshot
• POST /api/screenshot/async
• POST /api/screenshot/bulk
• GET /api/screenshot/{id}

Example usage

# Sync screenshot (image response)
curl "http://localhost/api/screenshot?url=https://example.com" --output example.png

# JSON response
curl "http://localhost/api/screenshot?url=https://example.com&response=json"

# Async screenshot
curl -X POST http://localhost/api/screenshot/async \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","full_page":true}'

# Bulk screenshot
curl -X POST http://localhost/api/screenshot/bulk \
  -H "Content-Type: application/json" \
  -d '{"items":[{"url":"https://example.com"},{"url":"https://example.com","full_page":true}]}'

# Stealth + rotate identity + US region bundle
curl "http://localhost/api/screenshot?url=https://example.com&stealth=1&ua_preset=rotate&locale=en-US&timezone=America/New_York"

# Mobile HiDPI capture with touch emulation
curl "http://localhost/api/screenshot?url=https://example.com&width=390&height=844&device_scale_factor=3&mobile=1&touch=1&ua_preset=iphone" --output mobile.png

# Crop the top-left 1200x630 pixels for a share image
curl "http://localhost/api/screenshot?url=https://example.com&clip_x=0&clip_y=0&clip_width=1200&clip_height=630" --output crop.png

# Capture with print CSS and reduced motion
curl "http://localhost/api/screenshot?url=https://example.com&media=print&reduced_motion=1" --output print-css.png

# Trigger lazy-loaded content, click a tab, and blur private text
curl "http://localhost/api/screenshot?url=https://example.com&lazy_load=1&selector_to_click=.pricing-tab&blur_selector=.email" --output clean.png

# ScreenshotAPI-compatible aliases are accepted for easier migration
curl "http://localhost/api/screenshot?url=https://example.com&file_type=jpg&image_quality=90&retina=1&wait_for_event=networkidle&fresh=1" --output migrated.jpg

# Proxy pool round robin
curl "http://localhost/api/screenshot?url=https://example.com&proxy_pool=1&proxy_strategy=round_robin"

Parameters

These are valid for GET /api/screenshot and POST /api/screenshot unless noted.

Migration aliases accepted by the API:

• file_type -> format
• image_quality -> quality
• wait_for_event -> wait_until
• output -> response
• block_js -> disable_js
• no_cookie_banners -> block_cookies
• omit_background -> transparent
• remove_selector -> remove_selectors
• blur_selector -> blur_selectors
• enable_caching -> cache

Identity presets

Use ua_preset to set a realistic UA + headers + locale + timezone bundle. You can also pass locale/timezone explicitly to override. The iphone preset also enables mobile viewport, touch input, and a HiDPI scale unless you override those fields.

• chrome-mac, chrome-win, safari-mac, iphone, firefox-win
• Region bundles: region-us, region-uk, region-eu, region-au, region-jp
• rotate or random to pick one of the configured presets

Configuration

All configuration is handled via app/.env.

Defaults

• SCREENSHOT_DEFAULT_WIDTH, SCREENSHOT_DEFAULT_HEIGHT, SCREENSHOT_DEFAULT_FORMAT, SCREENSHOT_DEFAULT_QUALITY
• SCREENSHOT_DEFAULT_STEALTH, SCREENSHOT_DEFAULT_LOCALE, SCREENSHOT_DEFAULT_TIMEZONE
• SCREENSHOT_DEFAULT_USER_AGENT (empty by default to match the Chromium UA), SCREENSHOT_DEFAULT_ACCEPT_LANGUAGE, SCREENSHOT_DEFAULT_ACCEPT (leave empty unless you know you need it)

Limits

• SCREENSHOT_MAX_WIDTH, SCREENSHOT_MAX_HEIGHT, SCREENSHOT_TIMEOUT

Caching

• SCREENSHOT_CACHE_ENABLED, SCREENSHOT_CACHE_TTL

Storage

• SCREENSHOT_STORAGE_PATH, SCREENSHOT_PUBLIC_URL

Security

• SCREENSHOT_RATE_LIMIT
• SCREENSHOT_API_KEY
• SCREENSHOT_BLOCKED_HOSTS
• SCREENSHOT_ALLOW_LOCALHOST
• SCREENSHOT_ALLOWED_HOSTS (comma-separated allowlist; overrides blocklist/private IP checks)

When SCREENSHOT_ALLOW_LOCALHOST=true, the validator also allows localhost, 127.0.0.1, host.docker.internal, and nginx (for self-capture inside Docker).

Queues

• SCREENSHOT_QUEUE_NAME, SCREENSHOT_RESULT_QUEUE

Proxy pool

• SCREENSHOT_PROXY_POOL_ENABLED
• SCREENSHOT_PROXY_POOL (comma-separated list)
• SCREENSHOT_PROXY_STRATEGY (random or round_robin)
• SCREENSHOT_PROXY_CACHE_KEY

Cleanup

• SCREENSHOT_CLEANUP_AFTER

Notes on stealth and proxies

Some sites aggressively detect automation. Stealth mode and region-aware identity bundles reduce friction, but they are not guaranteed to bypass every detection system. For hard targets, use a residential proxy and align locale, timezone, and ua_preset.

Services

docker compose up starts:

• Nginx (reverse proxy)
• Laravel (API)
• Redis (queues/cache)
• PostgreSQL (database)
• Node screenshot worker (Puppeteer)

Project structure

• app/ Laravel application
• app/screenshot-worker/ Node.js worker (TypeScript + Puppeteer)
• docker/ Dockerfiles and configs
• docker-compose.yml Local stack

License

MIT