Skip to content

lyu0805/OpenBrowser

Repository files navigation

OpenBrowser

Version Platform License Node

Multi-language support / 多国语言支持

🇺🇸 English · 🇨🇳 中文

Local fingerprint browser · Isolated Chromium profiles · Proxy / fingerprint / sync / RPA


Overview

OpenBrowser is a local desktop fingerprint browser for managing multiple isolated Chromium environments. It combines profile isolation, proxy configuration, browser fingerprint controls, extension management, window synchronization, a local API, MCP integration, and local RPA workflows in one desktop app.

The app supports multiple UI languages, currently including English and Chinese.

Read the disclaimer before use. OpenBrowser does not guarantee anonymity, unique fingerprints, or compatibility with any specific website.

Contents

Screenshots

Overview Environments
Overview Environments
Main navigation and module entry points Profiles, start/stop controls, and groups
Profile / fingerprint Local settings
Profile editor Settings
Proxy, fingerprint, and extension settings Theme, language, and system options

Key features

Area What it provides
Profile isolation Separate Chromium profiles so cookies, cache, and storage do not mix.
Batch management Groups, tags, bulk start/stop, logs, and window sizing.
Proxy support HTTP / HTTPS / SOCKS proxies per environment, with egress checks.
Fingerprint controls Platform, language, timezone, user agent, Canvas, WebGL, WebRTC, and more.
Extension center Built-in, recommended, and local extensions loaded per environment.
Window sync CDP-based synchronization for clicks, scrolling, input, and tabs.
Local RPA Flows for navigation, waiting, clicking, typing, and screenshots.
Local API / MCP Local integration endpoint on 127.0.0.1:50325 by default.
Independent kernel Download a standalone Chromium kernel or use a custom local path.
Backup options Local, WebDAV, GitHub, and cloud-drive backups when explicitly enabled.

Supported platforms

Platform Architecture Status
Windows x86_64 ✅ Supported
macOS x86_64 ✅ Supported
macOS arm64 ✅ Supported

Quick start

Requires Node.js LTS and npm.

cd Browserapp
npm ci --include=dev
npm run selftest
npm start

Or use the launcher scripts from the repository root:

Platform Launcher
macOS start-test.command
Windows start-test.cmd

Packaging

cd Browserapp
# Optional: OPENBROWSER_PACKAGE_ARCH=x86_64 or arm64
npm run package:portable

Build output is written to Browserapp/dist/.

Platform Output notes
Windows Includes START.cmd.
macOS Includes OpenBrowser.app and 启动.command.

Self-tests

cd Browserapp
npm run selftest
npm run selftest:automation
npm run selftest:protocol
npm run selftest:isolation
npm run selftest:kernel
npm run selftest:cloud

Project layout

OpenBrowser/
├── Browserapp/            # App source
├── docs/screenshots/      # Screenshots
├── start-test.command     # macOS launcher
├── start-test.cmd         # Windows launcher
├── DISCLAIMER.md
├── LICENSE
├── README.md              # English documentation
└── README_CN.md           # Chinese documentation

This repository contains source code and documentation only. It does not include profiles, cookies, proxy credentials, bundled kernel binaries, or installers. Official Windows x64 and macOS arm64 builds download the matching Wayfern kernel during CI packaging; macOS x86_64 builds include the OpenBrowser 148 kernel.

Data and security

  • The local API binds to loopback by default.
  • If OPENBROWSER_API_KEY is set, requests must include the api-key header.
  • Browser startup failures are appended to the local-only browser-startup.log under the user's OpenBrowser data directory. Inspect it with npm run log:startup from Browserapp/; logs are ignored by Git.
  • Third-party notices are documented in THIRD-PARTY-NOTICES.md.
  • Cloud backup integrations only connect outward after explicit user configuration.

Documentation


Third-party kernel sources

The independent kernel comes from Donut Browser / Wayfern by zhom. Update feed: wayfern.json. Terms: Wayfern ToS.

The repository does not store kernel binaries. Official platform packages obtain the matching Wayfern kernel from the official feed during CI packaging; macOS x86_64 packages use the checked-in OpenBrowser 148 runtime.

License

MIT


If OpenBrowser is useful to you, a Star is appreciated ⭐

About

本地指纹浏览器 · 多环境隔离 · 代理 / 指纹 / 同步 / RPA

Topics

Resources

License

Stars

235 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors