Windows Guide
Settings, tray and pausing (Windows)
Pause ProxyBridge without closing it, use the system tray, start it with Windows, change language and text size, and check for updates. A tour of every menu in ProxyBridge for Windows.
Settings, tray and pausing
This page covers the menus of the main window and the things around the rules: the main on/off switch, the tray icon, starting with Windows, language, text size and updates.
The menus at a glance
| Menu | Items |
|---|---|
| Proxy | Enable ProxyBridge, Proxy Settings..., Proxy Rules..., Log Filters... |
| Profile | New Profile..., Rename Profile, Delete Current Profile, Import Profile..., Export Profile..., Switch Profile |
| Settings | Enable Traffic Logging, Close to Tray, Run at Startup, Auto Clear Logs, Log Every Connection, text size, Language |
| Help | Documentation, Check for Updates..., About |
Next to the menus there are two quick-access icons: the gear opens Proxy Settings and the list opens Proxy Rules.
Pausing ProxyBridge
Untick Proxy > Enable ProxyBridge to switch every rule off without closing the app or deleting anything. The same switch is in the tray menu.
While ProxyBridge is paused:
- New connections go out directly. Proxy rules and Block rules do not apply.
- The window title and the tray tooltip show (PAUSED).
- Connections that were already being proxied keep working until they end.
Tick Enable ProxyBridge again to apply the rules to new connections. ProxyBridge always starts enabled; the switch is not remembered between runs.
Use it to quickly test "does this problem go away without the proxy?", or to let a program reach a site that a rule would otherwise block.
The tray icon
ProxyBridge puts an icon in the notification area.
- Double-click the icon to show the window.
- Right-click for a small menu: Show ProxyBridge, Enable ProxyBridge (ticked when active) and Exit.
- The tooltip shows the app name, and (PAUSED) when paused.
Close to Tray
With Settings > Close to Tray ticked, the window's close button hides ProxyBridge in the tray and keeps it running, so your rules stay active. To quit completely, use Exit in the tray menu. With the option off, closing the window quits the app.
Rules only work while ProxyBridge is running. If you close the window with Close to Tray off, routing stops.
Run at Startup
Settings > Run at Startup starts ProxyBridge when you sign in to Windows. It starts hidden in the tray, so your rules apply without you opening the window.
This is a per-user setting and needs no administrator rights or UAC prompt. It works because the privileged part runs as the ProxyBridge Service.
Traffic logging options
Enable Traffic Logging, Auto Clear Logs and Log Every Connection control the Connections log. They are explained on the Connections, Live Connections and logs page. All three are saved with the active profile.
Language
Settings > Language switches the whole interface between English and 中文 (Chinese) immediately, without restarting. The choice is saved with the profile.
Text size
For high-resolution screens or tired eyes, the text size can be changed from 60% to 300%:
| Action | Shortcut |
|---|---|
| Increase text size | Ctrl + or Ctrl + mouse wheel up |
| Decrease text size | Ctrl - or Ctrl + mouse wheel down |
| Reset to 100% | Ctrl 0 |
The same actions are in the Settings menu. The size is saved with the profile. ProxyBridge follows the Windows display scaling automatically, so the text size setting is for extra adjustment on top.
Updates
- Help > Check for Updates... looks for a newer version and shows its release notes. Update Now downloads the installer and starts it; Later closes the message.
- ProxyBridge also checks quietly when it starts. Choose Don't Ask Again in the update message to turn that off.
- You can always get the latest installer from the download page or the releases page.
See Install on Windows for what the installer does to an existing installation.
Help
- Documentation opens this documentation site, proxybridge.interceptsuite.com/docs. Versions before 4.3.0 opened an older page.
- About shows the version, the author and the licence (MIT).
One window at a time
ProxyBridge allows one running copy. If you start a second window, or the command line while the app is open, it stops with a message: "ProxyBridge is already running (GUI or CLI). Please close the other instance first." Two copies would fight over the same network driver.
