Getting Started
Install BotBrowser, launch it from automation frameworks, manage profiles, and verify fingerprint behavior before scaling out.
New to this section? Start with Installation.
Use This Section When You Need To
- You are setting up BotBrowser for the first time.
- You need a minimal Playwright or Puppeteer launch that stays profile-consistent.
- You want the shortest path from install to first verification.
Recommended Reading Order
- Installation - Install BotBrowser on Windows, macOS, and Linux, verify the binary and profile path, then start the first session before connecting automation.
- Playwright - Launch BotBrowser with Playwright: profile-first startup, proxy-aware browser contexts, cleanup rules, and repeatable automation configuration.
- Puppeteer - Launch BotBrowser with Puppeteer using Chrome-mode startup and profile-controlled viewport behavior.
- First Verification - Verify a new BotBrowser install: fingerprint checks, profile loading, proxy alignment, and cross-platform consistency before automating.
All Guides
| Guide | Description |
|---|---|
| Installation | Install BotBrowser on Windows, macOS, and Linux, verify the binary and profile path, then start the first session before connecting automation. |
| Playwright | Launch BotBrowser with Playwright: profile-first startup, proxy-aware browser contexts, cleanup rules, and repeatable automation configuration. |
| Puppeteer | Launch BotBrowser with Puppeteer using Chrome-mode startup and profile-controlled viewport behavior. |
| Bot Script | Bot Script and BotScript automation in BotBrowser: —bot-script syntax, botscripts, Chrome Debugger API events, and a worked example. |
| CLI Recipes | BotBrowser CLI recipes for profile loading, proxy routing, identity configuration, headless startup, and repeatable server deployment. |
| Google Translate Page Translation | Use your own Google Cloud API key to enable page translation in BotBrowser. |
| Profile Management | Manage BotBrowser profile files, versions, and storage paths so browser identity stays reproducible across sessions, hosts, and deployments. |
| First Verification | Verify a new BotBrowser install: fingerprint checks, profile loading, proxy alignment, and cross-platform consistency before automating. |
Updated