Skip to content

Force Proxy to any Windows/MacOS/Linux Application TCP and UDP traffic

added mac screenshot, build, updated readme

Sourav Kalal200f0cbfd535
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
new file mode 100644
index 0000000..f91adb8
--- /dev/null
+++ b/.github/FUNDING.yml
@@ -0,0 +1,3 @@
+github: Anof-Cyber
+custom:
+ - https://www.buymeacoffee.com/AnoF
\ No newline at end of file
diff --git a/.github/workflows/build-mac.yml b/.github/workflows/build-mac.yml
new file mode 100644
index 0000000..57bcc25
--- /dev/null
+++ b/.github/workflows/build-mac.yml
@@ -0,0 +1,38 @@
+name: Build macOS
+
+on:
+ push:
+ branches: [ dev, main, master ]
+ pull_request:
+ branches: [ dev, main, master ]
+ workflow_dispatch:
+
+jobs:
+ build:
+ runs-on: macos-latest
+
+ steps:
+ - name: Checkout code
+ uses: actions/checkout@v4
+
+ - name: Set up Xcode
+ uses: maxim-lobanov/setup-xcode@v1
+ with:
+ xcode-version: latest-stable
+
+ - name: Build ProxyBridge
+ run: |
+ cd MacOS/ProxyBridge
+ chmod +x build.sh
+ ./build.sh
+ env:
+ SIGN_APP: ""
+ SIGN_PKG: ""
+ NOTARIZE: ""
+
+ - name: Upload PKG artifact
+ uses: actions/upload-artifact@v4
+ with:
+ name: ProxyBridge-macOS
+ path: MacOS/ProxyBridge/output/ProxyBridge-Installer.pkg
+ retention-days: 30
diff --git a/MacOS/ProxyBridge/build.sh b/MacOS/ProxyBridge/build.sh
index 8ff0014..ac62cf2 100755
--- a/MacOS/ProxyBridge/build.sh
+++ b/MacOS/ProxyBridge/build.sh
@@ -11,7 +11,7 @@ fi
PROJECT_NAME="ProxyBridge"
SCHEME_NAME="ProxyBridge"
OUTPUT_DIR="$SCRIPT_DIR/output"
-PKG_NAME="ProxyBridge-Installer.pkg"
+PKG_NAME="ProxyBridge-v3.0-Universal-Installer.pkg"
PKG_PATH="$OUTPUT_DIR/$PKG_NAME"
ARCHIVE_PATH="$SCRIPT_DIR/build/${PROJECT_NAME}.xcarchive"
EXPORT_PATH="$SCRIPT_DIR/build/Export"
diff --git a/MacOS/README.md b/MacOS/README.md
index bdbf09c..f1fe828 100644
--- a/MacOS/README.md
+++ b/MacOS/README.md
@@ -20,6 +20,12 @@ ProxyBridge is a transparent proxy application for macOS that allows you to rout
ProxyBridge leverages macOS Network Extension framework to intercept and route network traffic. It provides a GUI application for configuration and uses a system extension to handle traffic routing based on user-defined rules.
+<p align="center">
+ <img src="../img/ProxyBridge-mac.png" alt="ProxyBridge macOS Main Interface" width="800"/>
+ <br/>
+ <em>ProxyBridge Main Window</em>
+</p>
+
## Architecture
@@ -174,6 +180,12 @@ ProxyBridge leverages macOS Network Extension framework to intercept and route n
Access proxy settings from **Menu Bar → Proxy → Proxy Settings**.
+<p align="center">
+ <img src="../img/proxy-setting-mac.png" alt="Proxy Settings Configuration" width="600"/>
+ <br/>
+ <em>Proxy Settings Window</em>
+</p>
+
#### Supported Proxy Types
- **HTTP** - Standard HTTP/HTTPS proxy
- **SOCKS5** - SOCKS5 proxy with optional UDP support
@@ -212,6 +224,12 @@ Password: (optional)
Access proxy rules from **Menu Bar → Proxy → Proxy Rules**.
+<p align="center">
+ <img src="../img/proxy-rule-mac.png" alt="Proxy Rules Management" width="800"/>
+ <br/>
+ <em>Proxy Rules Window</em>
+</p>
+
Rules determine how network traffic is handled. Multiple rules can be created, and they are evaluated in order until a match is found.
#### Rule Components
@@ -239,6 +257,12 @@ Rules determine how network traffic is handled. Multiple rules can be created, a
- **Delete** - Remove rules permanently
- **List All** - View all configured rules and their status
+<p align="center">
+ <img src="../img/proxy-rule2-mac.png" alt="Add/Edit Proxy Rule" width="600"/>
+ <br/>
+ <em>Add/Edit Rule Window</em>
+</p>
+
#### Rule Examples
**Block all traffic from specific app**
diff --git a/README.md b/README.md
index 7c677d6..2e57b67 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,22 @@ ProxyBridge is a lightweight, open-source universal proxy client (Proxifier alte
> 🚀 **Need advanced traffic analysis?** Check out [**InterceptSuite**](https://github.com/InterceptSuite/InterceptSuite) - our comprehensive MITM proxy for analyzing TLS, TCP, UDP, DTLS traffic. Perfect for security testing, network debugging, and system administration!
+<p align="center">
+ <a href="https://github.com/sponsors/Anof-cyber">
+ <img src="https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86" alt="Sponsor Anof-cyber" width="230" height="50">
+ </a>
+</p>
+
+## Table of Contents
+
+- [Features](#features)
+- [Platform Documentation](#platform-documentation)
+- [Screenshots](#screenshots)
+- [Use Cases](#use-cases)
+- [License](#license)
+- [Author](#author)
+- [Credits](#credits)
+
## Features
- **Cross-platform** - Available for Windows and macOS
@@ -26,6 +42,10 @@ ProxyBridge is a lightweight, open-source universal proxy client (Proxifier alte
## Platform Documentation
+<a href="https://github.com/sponsors/Anof-cyber"><img src="https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86" alt="Sponsor Anof-cyber" width="230" height="50"></a>
+
+## Platform Documentation
+
ProxyBridge is available for both Windows and macOS, with platform-specific implementations:
### 📘 [Windows Documentation](Windows/README.md)
@@ -41,6 +61,70 @@ ProxyBridge is available for both Windows and macOS, with platform-specific impl
- **Requirements**: macOS 13.0 (Ventura) or later, Apple Silicon (ARM) or Intel
- **GUI**: Native SwiftUI interface
+## Screenshots
+
+### macOS
+
+<p align="center">
+ <img src="img/ProxyBridge-mac.png" alt="ProxyBridge macOS Main Interface" width="800"/>
+ <br/>
+ <em>ProxyBridge GUI - Main Interface</em>
+</p>
+
+<p align="center">
+ <img src="img/proxy-setting-mac.png" alt="Proxy Settings macOS" width="800"/>
+ <br/>
+ <em>Proxy Settings Configuration</em>
+</p>
+
+<p align="center">
+ <img src="img/proxy-rule-mac.png" alt="Proxy Rules macOS" width="800"/>
+ <br/>
+ <em>Proxy Rules Management</em>
+</p>
+
+<p align="center">
+ <img src="img/proxy-rule2-mac.png" alt="Add/Edit Rule macOS" width="800"/>
+ <br/>
+ <em>Add/Edit Proxy Rule</em>
+</p>
+
+### Windows
+
+#### GUI
+
+<p align="center">
+ <img src="img/ProxyBridge.png" alt="ProxyBridge Windows Main Interface" width="800"/>
+ <br/>
+ <em>ProxyBridge GUI - Main Interface</em>
+</p>
+
+<p align="center">
+ <img src="img/proxy-setting.png" alt="Proxy Settings" width="800"/>
+ <br/>
+ <em>Proxy Settings Configuration</em>
+</p>
+
+<p align="center">
+ <img src="img/proxy-rule.png" alt="Proxy Rules" width="800"/>
+ <br/>
+ <em>Proxy Rules Management</em>
+</p>
+
+<p align="center">
+ <img src="img/proxy-rule2.png" alt="Add/Edit Rule" width="800"/>
+ <br/>
+ <em>Add/Edit Proxy Rule</em>
+</p>
+
+#### CLI
+
+<p align="center">
+ <img src="img/ProxyBridge_CLI.png" alt="ProxyBridge CLI" width="800"/>
+ <br/>
+ <em>ProxyBridge CLI Interface</em>
+</p>
+
## Use Cases
- Redirect proxy-unaware applications (games, desktop apps) through InterceptSuite/Burp Suite for security testing
diff --git a/img/ProxyBridge-mac.png b/img/ProxyBridge-mac.png
new file mode 100644
index 0000000..cab7092
Binary files /dev/null and b/img/ProxyBridge-mac.png differ
diff --git a/img/proxy-rule-mac.png b/img/proxy-rule-mac.png
new file mode 100644
index 0000000..c465349
Binary files /dev/null and b/img/proxy-rule-mac.png differ
diff --git a/img/proxy-rule2-mac.png b/img/proxy-rule2-mac.png
new file mode 100644
index 0000000..e8ae48d
Binary files /dev/null and b/img/proxy-rule2-mac.png differ
diff --git a/img/proxy-setting-mac.png b/img/proxy-setting-mac.png
new file mode 100644
index 0000000..07d76a0
Binary files /dev/null and b/img/proxy-setting-mac.png differ