How xoxma1993/shardbrowser works
ShardX is a desktop anti-detect browser launcher for managing isolated browser profiles and running them with configured fingerprints and proxies. Users prepare profiles, then launch and control browser sessions through the desktop workspace, local HTTP API, MCP server, or standalone SDKs. The README documents cookie handling, extensions, bookmarks, automation, and proxy management as additional capabilities. Sampled UI stores call Tauri commands, while the backend owns persistence and browser lifecycle; README-described integration details are included without asserting unsampled internal wiring.
Main entry points: lib.rs Tauri commands · App.tsx Desktop UI · launch.rs Browser launch · api.rs Local HTTP API
Components 22
Control surfaces
- Desktop UI
src/app/App.tsx - Local HTTP API
src-tauri/src/api.rs
Launcher workspace
- Profiles
src/entities/profile/lib/useProfile.tsx - Proxy manager
src/entities/proxy/lib/useProxy.tsx - Fingerprint library
src/entities/fingerprint/lib/useFingerprint.tsx - Automation editor
src/entities/automation/lib/useAutomation.tsx - Extensions
src/entities/extension/lib/useExtensions.tsx - Workspace tools
src/pages
Native runtime
- Tauri commands
src-tauri/src/lib.rs - Profile lifecycle
src-tauri/src/profile.rs - Proxy handling
src-tauri/src/proxy.rs - Fingerprint data
src-tauri/src/fingerprints.rs - Automation runtime
src-tauri/src/automation.rs - Browser launch
src-tauri/src/launch.rs - Local state
src-tauri/src/db.rs
Automation clients
- MCP server
mcp/index.js - SDKs
sdks
Browser operation
- Patched Chromium
- CDP control
src-tauri/src/cdp.rs - Browser actions
mcp/index.js
Other components
- Operator
- ProxyShard service
Connections 35
- Operator → Desktop UI: uses
- Operator → Local HTTP API: requests control
- Operator → MCP server: prompts
- Operator → SDKs: runs
- Desktop UI → Profiles: navigates
- Desktop UI → Proxy manager: navigates
- Desktop UI → Fingerprint library: navigates
- Desktop UI → Automation editor: navigates
- Desktop UI → Extensions: navigates
- Desktop UI → Workspace tools: navigates
- Profiles → Tauri commands: invokes commands
- Proxy manager → Tauri commands: invokes commands
- Fingerprint library → Tauri commands: invokes commands
- Automation editor → Tauri commands: invokes commands
- Extensions → Tauri commands: invokes commands
- Local HTTP API → Tauri commands: dispatches
- MCP server → Local HTTP API: calls API
- MCP server → CDP control: connects
- SDKs → Local HTTP API: controls profiles
- Tauri commands → Profile lifecycle: dispatches
- Tauri commands → Proxy handling: dispatches
- Tauri commands → Fingerprint data: dispatches
- Tauri commands → Automation runtime: dispatches
- Profile lifecycle → Local state: reads/writes
- Proxy handling → Local state: reads/writes
- Fingerprint data → Local state: reads/writes
- Automation runtime → Local state: reads/writes
- Tauri commands → Browser launch: starts/stops
- Browser launch → Profile lifecycle: loads profile
- Browser launch → Patched Chromium: launches
- Browser launch → Proxy handling: configures proxy
- Patched Chromium → CDP control: exposes endpoint
- CDP control → Browser actions: controls session
- Browser actions → Patched Chromium: automates
- ProxyShard service → Proxy handling: optional proxy service