BotBrowser Control

Professional desktop profile manager for BotBrowser

Features · Install · Build · Usage · Configuration

BotBrowser Control is an open-source Electron desktop application that provides a GoLogin-style GUI for managing and launching BotBrowser profiles. It handles per-profile user data isolation, fingerprint configuration, proxy assignment, cookie persistence, and live session monitoring — all without touching the command line.

Profiles View

Settings

Profile Editor

• Profile Manager — Create, edit, duplicate, and delete browser profiles with a clean table UI
• VS Code-style Profile Editor — 7-tab sidebar editor (General, Network, Identity, Fingerprint, Behavior, Session, Advanced)
• One-click Launch / Stop — Spawn and kill BotBrowser instances per profile
• Per-profile User Data — Each profile gets an isolated --user-data-dir automatically
• Proxy Support — HTTP, HTTPS, SOCKS4, SOCKS5 with credentials, per-profile
• Fingerprint Configuration — Map to all BotBrowser --bot-config-* flags: locale, timezone, WebGL, WebRTC, canvas noise, seeds, etc.
• .enc Profile File Support — Load BotBrowser encrypted fingerprint profiles
• Cookie Persistence — Auto-save and reload cookies via CDP on stop/start
• Session Monitor — Live view of all running browser instances with PID and start time
• Settings Page — Configure BotBrowser executable path, default user data directory, default proxy
• Dark / Light Theme — Follows system theme; manual override available
• macOS native — Hidden titlebar, traffic lights, vibrancy effect
• Cross-platform — Works on macOS, Windows, and Linux

Go to Releases and download the installer for your platform:

# 1. Clone the repository
git clone https://github.com/botswin/BotBrowser.git
cd BotBrowser/botbrowser-control   # adjust path if this is a standalone repo

# 2. Install dependencies
npm install

# 3. Launch in development mode
npm start

node --version   # v18+
npm --version    # v9+
npm install      # install all dependencies first

# Build for ALL platforms (Mac + Windows + Linux)
npm run build

# macOS only (produces .dmg and .zip for x64 + arm64)
npm run build:mac

# Windows only (produces NSIS installer + portable + zip)
npm run build:win

# Linux only (produces AppImage + .deb + .rpm + tar.gz)
npm run build:linux

All artifacts are written to the dist/ directory.

npm run build:mac:x64      # macOS Intel
npm run build:mac:arm64    # macOS Apple Silicon
npm run build:win:x64      # Windows 64-bit
npm run build:win:ia32     # Windows 32-bit
npm run build:linux:x64    # Linux x64
npm run build:linux:arm64  # Linux ARM64

You can build macOS and Linux targets from any Unix machine. Building Windows targets from macOS/Linux requires Wine:

# macOS
brew install --cask wine-stable

# Ubuntu/Debian
sudo apt install wine64

Recommended: Use GitHub Actions to produce official releases for all three platforms in parallel. See BUILD.md for the full workflow YAML.

1. Launch the app (npm start or open the installed .app / .exe)
2. Click Settings in the left sidebar
3. Set the BotBrowser Executable path to your BotBrowser binary:
   • macOS: /Applications/Chromium.app/Contents/MacOS/Chromium
   • Windows: C:\Program Files\BotBrowser\chrome.exe
   • Linux: /usr/bin/botbrowser
4. (Optional) Set a Default User Data Directory — defaults to ~/Library/Application Support/BotBrowser Control/browser-profiles
5. Click Save Settings

1. Click + New Profile in the Profiles view
2. Fill in the General tab: name, browser brand, start URL, .enc profile file
3. Configure Network tab: proxy server, IP override
4. Optionally set fingerprint details in Identity, Fingerprint, Behavior tabs
5. Click Save Changes

• Click the ▶ Launch button on any profile row
• The profile opens as a standalone BotBrowser window
• Status changes to Running (green pill)
• Click ■ Stop to close the browser and auto-save cookies

• Click Sessions in the left sidebar to see all live instances
• Each entry shows: profile name, PID, start time, and URL
• Use Stop All to terminate every running instance at once

The profile editor maps directly to BotBrowser CLI flags. The most important fields:

For the full list of supported flags see BotBrowser CLI_FLAGS.md.

botbrowser-control/
├── src/
│   ├── main/
│   │   └── main.js          # Electron main process (IPC, browser launch, store)
│   ├── preload/
│   │   └── preload.js       # contextBridge API exposed to renderer
│   ├── renderer/
│   │   ├── index.html       # App shell HTML
│   │   ├── styles/
│   │   │   └── main.css     # Full UI stylesheet (dark theme, GoLogin-inspired)
│   │   └── js/
│   │       └── app.js       # Renderer logic (renderProfiles, editor, settings)
│   └── assets/
│       ├── icon.png         # App icon (1024×1024, used for all platforms)
│       └── logo.svg         # Sidebar SVG logo
├── preview/
│   └── index.html           # Standalone HTML UI preview (no Electron needed)
├── package.json             # Electron + electron-builder config
├── BUILD.md                 # Detailed build instructions
└── README.md                # This file

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Make your changes
4. Run the app to verify: npm start
5. Commit and push: git push origin feature/my-feature
6. Open a Pull Request

MIT — see LICENSE for details.