Browser Profiles

Zeus Desktop supports multi-profile browser management, allowing you to create and manage multiple isolated browser instances — each with its own cookies, storage, login state, proxy, and fingerprint configuration.

Overview

Browser Profiles is a core feature of Zeus Desktop, providing environment isolation similar to products like Multilogin or AdsPower. Each profile runs in a completely independent Chrome instance with its own user-data-dir, ensuring full data isolation between profiles.

Key Features

Feature	Description
Complete Isolation	Each profile has independent cookies, localStorage, cache, and login sessions
Proxy Support	Configure HTTP/HTTPS/SOCKS5 proxies per profile
Fingerprint Spoofing	Customize browser fingerprints to prevent tracking and detection
Visual Identity	Assign unique colors and icons to each profile for easy identification
Concurrent Sessions	Run multiple profiles simultaneously without interference

Architecture

Profile Data Model

Each browser profile stores the following configuration:

interface BrowserProfile {
  id: string;               // Unique identifier
  name: string;             // Display name
  color: string;            // Visual color tag
  iconPath?: string;        // Custom icon path
  browserDataPath: string;  // Chrome user-data-dir path
  createdAt: string;        // Creation timestamp
  lastUsedAt?: string;      // Last used timestamp
  homepageUrl?: string;     // Homepage URL
  userAgent?: string;       // Custom User-Agent
  proxy?: ProxyConfig;      // Proxy settings (see Proxy IP doc)
  fingerprint?: FingerprintConfig; // Fingerprint settings (see Fingerprint doc)
}

Creating a Profile

The profile creation dialog is organized into three tabs:

1. Basic Info

Profile Name (required) — A descriptive name for identifying this profile
Homepage URL (optional) — The page that opens when the profile launches

2. Proxy Settings

Configure a proxy for this profile. See Proxy IP for details.

3. Fingerprint Configuration

Customize the browser fingerprint. See Browser Fingerprint for details.

Profile Lifecycle

Launch Process

When you launch a profile, Zeus Desktop:

Assigns a debug port — Finds an available port for Chrome DevTools Protocol (CDP)
Builds launch arguments — Constructs Chrome flags including --user-data-dir, --proxy-server, --user-agent, --lang
Starts Chrome process — Spawns a Chrome instance with the configured arguments
Waits for CDP — Polls the debug port until Chrome is ready
Injects fingerprint — Connects via CDP WebSocket to apply advanced fingerprint overrides and anti-detection scripts
Returns control — The browser is now ready for use

macOS App Wrapper

On macOS, each profile is wrapped as a standalone .app bundle in the Dock, with its own icon and name. This provides a native macOS experience where each profile appears as an independent application.

Data Isolation

Each profile’s data is stored in a separate directory:

~/.zeus-profiles/
├── profile-abc123/
│   ├── Default/           # Chrome user data
│   ├── Cookies
│   ├── Local Storage/
│   └── ...
├── profile-def456/
│   ├── Default/
│   └── ...
└── profiles.json          # Profile metadata

This ensures:

No cookie leakage between profiles
No shared login sessions
Independent cache and history
Complete localStorage isolation

Managing Profiles

View Configuration

Click the settings icon on any profile card to view its full configuration, including:

Basic information (name, homepage)
Proxy status (type, address, authentication)
Fingerprint summary (UA, language, timezone, resolution, protection status)

Update Profile

You can modify a profile’s configuration at any time. Changes to proxy and fingerprint settings will take effect on the next browser launch.

Delete Profile

Deleting a profile removes both the metadata and the associated user-data-dir, permanently clearing all browsing data for that profile.

Web

Desktop

Chrome Extension

iOS

Android

CLI

Browser Profiles

Overview

Key Features

Architecture

Profile Data Model

Creating a Profile

1. Basic Info

2. Proxy Settings

3. Fingerprint Configuration

Profile Lifecycle

Launch Process

macOS App Wrapper

Data Isolation

Managing Profiles

View Configuration

Update Profile

Delete Profile

​Overview

​Key Features

​Architecture

​Profile Data Model

​Creating a Profile

​1. Basic Info

​2. Proxy Settings

​3. Fingerprint Configuration

​Profile Lifecycle

​Launch Process

​macOS App Wrapper

​Data Isolation

​Managing Profiles

​View Configuration

​Update Profile

​Delete Profile

Overview

Key Features

Architecture

Profile Data Model

Creating a Profile

1. Basic Info

2. Proxy Settings

3. Fingerprint Configuration

Profile Lifecycle

Launch Process

macOS App Wrapper

Data Isolation

Managing Profiles

View Configuration

Update Profile

Delete Profile