Antifoxyz Documentation

Complete guide to using Antifoxyz antidetect browser manager — from basic profile setup to advanced API automation.

Overview

Antifoxyz is a desktop application for managing multiple isolated browser profiles, each with a unique digital fingerprint. It includes:

• Profile Management — Create, edit, tag, group, search, and bulk-manage browser profiles
• Browser Engine — Launch Firefox-based browsers with anti-detection fingerprinting
• Proxy System — Per-profile proxy assignment, pool management, health checking, auto-rotation
• Cookie Management — Import, export, copy cookies between profiles (JSON & Netscape formats)
• Automation — Run Python scripts across profiles with a built-in task engine
• Extensions — Install and manage Firefox extensions (.xpi) per profile
• REST API — Full local API at http://localhost:3131/api/v1 for external automation

Installation

1. Download Antifoxyz from the Downloads page
2. Open the application — a desktop window and local API server start automatically
3. The API runs on http://localhost:3131 by default
4. You're ready — start by creating your first profile

Create Your First Profile

1. Click New Profile in the sidebar
2. Enter a profile name (e.g., "Account 1")
3. Optionally set a proxy in the format host:port:user:pass
4. Choose OS type (Windows / macOS / Linux) — this affects the browser fingerprint
5. Click Create
6. Your profile appears in the list — click the Play button to launch the browser

Profile Management

Creating Profiles

Each profile is an isolated browser instance with its own fingerprint, cookies, extensions, and proxy.

Single Profile

1. Click New Profile in the sidebar
2. Fill in the dialog:
   • Name (required) — unique identifier
   • Proxy — format: host:port:user:pass or host:port
   • OS Type — Windows, macOS, or Linux
   • Language — browser locale (en-US, vi, zh-CN, etc.)
   • Group — organizational label
   • Notes — free-text notes
3. Switch to Fingerprint tab to customize:
   • Screen Resolution, WebGL Vendor/Renderer
   • Hardware Concurrency, Device Memory
   • Timezone, WebRTC Mode, Canvas Noise
4. Switch to Extensions tab to enable/disable extensions
5. Click Create

Bulk Create Pro

1. Click the Bulk button next to "New Profile"
2. Choose naming mode:
   • Index — sequential: Profile-0, Profile-1, Profile-2...
   • Random — random names: swift-fox-42, blue-owl-17...
   • Custom — paste names, one per line
3. Set count (1–500) and OS type
4. Click Create Profiles

Edit & Delete

Edit: Click the pencil icon on any profile card, or click the card to open the detail panel and click Edit.

Delete: Click the trash icon on the profile card. Confirm in the dialog. This permanently removes the profile and its browser data.

Search & Filter

The search bar at the top supports:

Bulk Operations Pro

Select multiple profiles using the checkboxes. A bulk action bar appears at the bottom with these actions:

Browser Launch & Stop

Click the Play button on a profile card to launch its browser. The browser opens as a full Firefox window with the profile's fingerprint, proxy, extensions, and cookies applied.

Click Stop to close the browser. All data (cookies, local storage, etc.) is saved to the profile's data directory.

Fingerprint Settings

Each profile's fingerprint makes it appear as a unique device to websites. Configure these in the profile editor's Fingerprint tab:

Proxy Management

Each profile can have its own proxy. Supported formats:

host:port
host:port:username:password
socks5://host:port:username:password
http://username:password@host:port

Check Proxy

Click the Check button in the detail panel or use the bulk "Check Proxy" action. The app tests connectivity and detects the public IP and country.

Proxy Pool

The proxy pool is a central collection of proxies you can assign to profiles. Access it from Proxy Pool in the sidebar.

Add Proxies

1. Open Proxy Pool from sidebar
2. Go to the Manage tab
3. Paste proxies, one per line
4. Click Import

Health Check

Click Check All to test every proxy in the pool. Results show alive (green), dead (red), or unchecked (gray).

Assign from Pool

Select profiles, click Pool Rotate in the bulk bar. Proxies are assigned using the configured strategy (round-robin or random).

Auto-Rotation

Enable per-profile proxy auto-rotation in the profile editor:

Cookie Management Pro

Manage cookies for each profile. The browser must be stopped to read/write cookies from disk.

View Cookies

Click the cookie icon on a profile card. Cookies are displayed grouped by domain with name, value, expiry, and flags (Secure, HttpOnly).

Import Cookies

Two methods:

• Quick Import (sidebar) — Paste JSON cookie array, creates a new profile with cookies
• Profile Import — Open cookie dialog, click Import, paste JSON or Netscape text

JSON format:

[
  {"name": "session_id", "value": "abc123", "domain": ".example.com", "path": "/"},
  {"name": "token", "value": "xyz789", "domain": "app.example.com", "path": "/", "secure": true}
]

Export Cookies

Export as JSON or Netscape format from the cookie dialog.

Copy Cookies Between Profiles

Use the API endpoint to copy cookies from one profile to one or more others (useful for sharing sessions).

Import & Export

Export Profiles Pro

1. Click Export in the sidebar
2. Select profiles to export
3. Toggle Include Browser Data to include cookies, cache, local storage
4. Choose export directory
5. Click Export — creates one ZIP per profile

Import Profiles

1. Click Import in the sidebar
2. Select a profile ZIP file (exported from Antifoxyz)
3. Profile is restored with all data

Import from Other Browsers Pro

Antifoxyz can import profiles from:

1. Click External Import in the sidebar
2. Select the source browser
3. Choose the exported JSON file
4. All profiles are imported with names, proxies, and fingerprint settings

Extension Library

Install Firefox extensions (.xpi) and assign them to profiles.

1. Click Extension Library in the sidebar
2. Click Install .xpi and select a Firefox extension file
3. The extension appears in the library
4. To assign: Edit a profile → Extensions tab → check the extension
5. The extension loads automatically when the profile's browser launches

Tool Marketplace

Automation tools are Python scripts that run actions inside browser profiles. Access from Tool Marketplace in the sidebar.

Creating a Tool

Tools are Python files in the tools/ directory. Each tool defines a class that inherits from Tool:

from antifoxyz.sdk import Tool

class MyTool(Tool):
    def get_info(self):
        return {
            "name": "Check IP",
            "version": "1.0.0",
            "description": "Check the public IP for each profile",
            "author": "Your Name",
            "tags": ["ip", "proxy"],
            "settings_schema": [
                {
                    "key": "timeout",
                    "label": "Timeout (seconds)",
                    "type": "number",
                    "default": 10
                }
            ]
        }

    async def run(self, browser, profile, settings):
        page = await browser.new_page()
        await page.goto("https://api.ipify.org?format=json")
        text = await page.text_content("body")
        await page.close()
        return {"status": "success", "ip": text}

Settings Schema Types

Running Tasks

1. Select profiles you want to run the tool on
2. Click Run Tool in the bulk bar
3. Select the tool from the dropdown
4. Configure tool settings (if any)
5. Click Start Task
6. Monitor progress in the Task History tab

The tool runs sequentially on each profile. You can configure a delay between profiles and auto-close browser after completion.

Marketplace Tools

Purchase additional tools from the Tool Marketplace. After purchase:

1. Download the tool .py file
2. Place it in the tools/ directory
3. Restart the app or refresh the tool list
4. The tool appears in your Tool Marketplace

API Authentication

The local API runs at http://localhost:3131/api/v1. All endpoints require an API key in the request header:

X-API-Key: AFX-a3f9c2d1b8e74f6a0123456789abcdef

Interactive API docs (Swagger UI) are available at http://localhost:3131/docs when debug mode is enabled (ANTIFOXYZ_DEBUG=1).

API Key Management

Generate API keys to authenticate external tools and scripts.

Generate a Key (GUI)

1. Open Tool Marketplace from sidebar
2. Go to API Access tab
3. Type a name for the key (e.g., "My Automation Script")
4. Click Generate Key
5. Copy the key immediately — it is shown only once!

API Endpoints

Request:  { "name": "My Script" }
Response: {
  "id": "key_abc123",
  "name": "My Script",
  "key": "AFX-a3f9c2d1b8e74f6a0123456789abcdef",
  "key_preview": "AFX-a3f9...",
  "created_at": "2026-01-15T10:30:00Z",
  "is_active": true
}

Profiles API

{ "name": "Account 1", "proxy": "host:port:user:pass",
  "os_type": "windows", "notes": "Main account",
  "tags": ["shop"], "browser_locale": "en-US" }

{ "names": ["P1", "P2", "P3"], "os_type": "windows" }

{ "ids": ["a1b2c3d4", "e5f6g7h8"] }

Browser API

{ "ids": ["a1b2c3d4", "e5f6g7h8"] }

{ "ids": ["a1b2c3d4", "e5f6g7h8"] }

Proxy API

Request:  { "proxy": "host:port:user:pass", "timeout": 10 }
Response: { "success": true, "message": "IP: 1.2.3.4", "country": "US" }

{ "ids": ["profile_id_1", "profile_id_2"], "timeout": 10 }

Proxy Pool API

{ "proxy_str": "host:port:user:pass", "name": "US Proxy 1", "country": "US" }

{ "text": "host1:port1\nhost2:port2:user:pass", "protocol": "http" }

{ "profile_ids": ["id1", "id2"], "strategy": "round_robin",
  "country": "US", "alive_only": true }

Cookies API Pro

{ "text": "[{\"name\":\"session\",\"value\":\"abc\",\"domain\":\".example.com\"}]" }

{ "from_profile_id": "abc", "to_profile_ids": ["def", "ghi"] }

Automation API

{ "tool_file": "check_ip.py",
  "profile_ids": ["a1b2c3d4", "e5f6g7h8"],
  "settings": { "timeout": 10 },
  "auto_close_browser": false,
  "delay_between_profiles": 2.0 }

Extensions API

{ "xpi_path": "/path/to/extension.xpi" }

License Activation

Antifoxyz is free to use with a 3-profile limit. Upgrade to Pro or Team for unlimited profiles and advanced features.

Activate a License

1. Click the license badge at the bottom of the sidebar
2. Enter your license key in the format AFXYZ-XXXXX-XXXXX-XXXXX-XXXXX
3. Click Activate
4. Your tier upgrades immediately — all features unlock

Validate Online

Click Validate Online in the license dialog to re-verify your license with the server. The app auto-validates on startup. A 30-day grace period allows offline use before degrading to Free.

Deactivate

Click Deactivate to revert to Free tier. Your profiles remain but Pro features become restricted.

Tier Comparison