Proxy Manager & User Agent Switcher — SEOULTRA

• Chrome Web Store: Proxy Manager & User Agent Switcher — SEOULTRA

A proxy manager and User-Agent switcher for Chrome built with Manifest V3. Toggle a fixed proxy on or off in one click, spoof your User-Agent with 17+ bot presets, and always know the state at a glance from the toolbar icon.

---

🚦 Toolbar status icon

Icon	Meaning
🎨 Colorful logo + 🟢 green dot	Proxy ON and connected
🎨 Colorful logo + 🔴 red dot	Proxy ON but not reachable / misconfigured
⚪ Grayscale logo (no dot)	Proxy OFF
⚪ Grayscale logo + UA badge	Proxy OFF, User-Agent ON
🎨 Colorful logo + 🟢 green dot + UA badge	Proxy ON connected + User-Agent ON
🎨 Colorful logo + 🔴 red dot + UA badge	Proxy ON not reachable + User-Agent ON

The icon updates automatically whenever you toggle proxy or User-Agent, save, or re-check.

---

✨ Features

Proxy

• One-click enable/disable from the popup
• Supports HTTP, HTTPS, SOCKS4, and SOCKS5
• Configurable host, port, and bypass list (e.g. <local>, 127.0.0.1, localhost)
• Automatic connectivity re-check after every change
• MV3-compliant: Chrome will prompt you if the proxy requires authentication

User-Agent Switcher

• Override your browser's User-Agent header from the popup or options page
• 17+ presets: Googlebot, Bingbot, YandexBot, Baiduspider, DuckDuckBot, Applebot, GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, Claude-Web, PerplexityBot, Bytespider, Cohere-AI, Twitterbot, Facebookbot, LinkedInBot
• Custom User-Agent text input
• Independent enable/disable toggle — works with or without proxy

General

• 6 toolbar icon states — instantly see proxy + UA status at a glance
• Mustang console popup — car-style vertical toggle switches with LED indicators
• Color-coded LEDs: green (proxy), cyan (UA)
• Two-way sync — popup and options page stay in sync in real time
• Professional design token system — consistent theming across popup and options
• Compact options page — scheme, host, port in one row with streamlined controls
• Settings stored locally in chrome.storage.local — nothing leaves your browser

---

📁 Project structure

proxy-manager-user-agent-seoultra-chrome-extension/
├── manifest.json               # MV3 manifest
├── popup.html                  # toolbar popup
├── options.html                # full settings page
├── description.txt             # Chrome Web Store listing copy
├── README.md
└── assets/
    ├── js/
    │   ├── background.js       # service worker: proxy, UA, icon, connectivity
    │   ├── popup.js            # popup logic
    │   └── options.js          # options page logic
    ├── css/
    │   └── styles.css          # shared theme (popup + options)
    ├── logo.png                # source logo
    ├── logo-{16,32,48,128}.png
    ├── icon_on-*.png           # proxy ON (green dot)
    ├── icon_warn-*.png         # proxy ON, not reachable (red dot)
    ├── icon_off-*.png          # proxy OFF (grayscale)
    ├── icon_both-*.png         # proxy ON + UA ON
    ├── icon_warn_ua-*.png      # proxy WARN + UA ON
    ├── icon_off_ua-*.png       # proxy OFF + UA ON
    └── icon-user-agent1.png    # UA badge source

---

📥 Installation

1. Download the latest release zip or clone the repo.
2. Open chrome://extensions in Chrome.
3. Enable Developer mode (top-right).
4. Click Load unpacked and select the extension folder.

Or install directly from the Chrome Web Store.

---

🛠 Development

git clone https://github.com/josuamarcelc/proxy-manager-user-agent-seoultra-chrome-extension.git
cd proxy-manager-user-agent-seoultra-chrome-extension
# edit files...

📝 Changelog

1.4.0

• Mustang console popup — redesigned as a car-style toggle console with vertical flip switches (up = ON, down = OFF), LED indicators, red glowing border, and SEOULTRA logo header.
• Icons on toggle levers — shield (proxy), user (UA), gear (setup), refresh (update) icons embedded on each switch handle.
• Compact options page — scheme, host, and port on a single row; streamlined buttons; "Proxy Setting" card title; SEOULTRA logo header.
• Professional CSS design tokens — 40+ CSS variables for consistent theming across popup and options (palette, surfaces, buttons, transitions, radii).
• Smooth popup open — pre-allocated dimensions + opacity fade-in prevents Chrome resize flash.

1.3.0

• User-Agent Switcher — new feature to override the browser's User-Agent header with 17+ bot presets (Googlebot, Bingbot, YandexBot, Baiduspider, DuckDuckBot, Applebot, GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, Claude-Web, PerplexityBot, Bytespider, Cohere-AI, Twitterbot, Facebookbot, LinkedInBot) plus custom text input.
• 6 toolbar icon states — unique icons for every combination of proxy (off/on/warn) and UA (off/on), with a cyan "UA" badge overlay when User-Agent is active.
• Options page UA section — full User-Agent card with cyan/teal theme, iOS-style toggle, dropdown, custom input, and live preview status bar.
• Popup redesigned — proxy and User-Agent are separate sections with independent Enable/Disable toggles, color-coded badges, and "UA ACTIVE" indicator.
• Footer moved — "Check for updates" link now lives in the popup footer.
• Renamed to Proxy Manager & User Agent Switcher — SEOULTRA.
• Added declarativeNetRequest permission for header modification.

1.2.1

• Two-way sync between popup and options — toggling Enable on either surface updates the other in real time via chrome.storage.onChanged.
• Refined footer on the options page: SEOULTRA brand (logo + name) linked to seoultra.id, single-row layout on desktop, stacked on mobile, with © 2021 - <year> SEOULTRA. All rights reserved.
• Page title updated to Minimal Proxy Setting — SEOULTRA.
• Service worker icon fix — chrome.action.setIcon now uses ImageData loaded via OffscreenCanvas, sidestepping the MV3 "Failed to fetch" error on install.
• README cleanup.

1.2.0

• Brand refresh — unified logo replaces the old "M" glyph. Grayscale when disabled, full color + green/red status dot when enabled.
• New inline status bar on the options page (replaces alert() popups) with themed ON/WARN/OFF states and live reason text (e.g. Proxy http://host:port is not reachable.).
• Big iOS-style ON/OFF toggle for the Enable switch, paired in the same row as Save / Disable & Clear / Re-check — now with SVG icons.
• Transparent popup background for a cleaner look in the toolbar.
• "Check for updates" link in both popup and options footer.
• Informative re-check: background.js now returns a full status object (state, host, port, scheme, reason) to the UI.
• Reorganized all icons into assets/ and refactored the background worker.
• Renamed to Minimal Proxy Manager — SEOULTRA.

1.1.0

• Initial public release with HTTP/HTTPS/SOCKS support, bypass list, and three-state toolbar icon.

---

🔒 Permissions

Permission	Why
proxy	Required to set Chrome's proxy configuration
storage	Saves settings locally
declarativeNetRequest	Required to modify the User-Agent request header
<all_urls>	Required so the proxy and UA override apply to all sites

No analytics. No tracking. No remote code. Open, auditable, and minimal by design.

---

💛 Support

If you find this extension useful, consider supporting the project: