🦁 Lion VPN is a modern, beautiful, and high-performance Compose Multiplatform GUI client designed for the domain-fronted proxy relay system.

It provides an intuitive, one-click graphical interface that bundles, launches, and manages the local Python proxy server on multiple platforms.

Language: English | Persian / فارسی

graph TD
    subgraph "Lion VPN GUI Client (Compose Multiplatform)"
        UI[Compose Multiplatform UI]
        AndroidApp[Android Client /com.darius.lionvpn]
        DesktopApp[Desktop Client /desktopApp]
        IosApp[iOS Client UI Preview]
    end
    
    subgraph "Local Python Proxy (Upstream Engine)"
        ProxyServer[Proxy Server /src/proxy]
        MITM[MITM Cert Manager /src/proxy/mitm]
        Fronter[Domain Fronter /src/relay]
    end
    
    subgraph "Google Apps Script Relay (Cloud)"
        GAS[Apps Script Web App]
        Target[Destination Site]
    end

    UI --> AndroidApp
    UI --> DesktopApp
    UI --> IosApp
    
    AndroidApp -->|Chaquopy JNI Bridge| ProxyServer
    DesktopApp -->|Embedded Executable| ProxyServer
    
    ProxyServer -->|Domain Fronted HTTPS| GAS
    GAS -->|Fetch Request| Target

• 🎨 Premium UI/UX: Built using state-of-the-art Compose Multiplatform styling, supporting dark mode, smooth micro-animations, and dynamic HSL color accents.
• 🔌 One-Click Connection: Simple, beautiful connect button with pulsating status indicator that boots and terminates the proxy server automatically in the background.
• 📱 Native Android Integration (VpnService): Custom Android system VPN wrapper that captures device traffic and routes it directly to the local SOCKS5/HTTP proxy, removing the need for manual browser proxy configuration.
• 💻 One-Click Desktop Executable: Optimized desktop build system that compiles and packages the Python proxy into a single standalone binary using PyInstaller.
• 🔒 HTTPS MITM Certificate Generator: Seamlessly generate, export, and trigger device installation prompts for the local CA intercept certificate natively from the interface.
• ⚡ Zero UI Blocking & High Performance: Highly optimized JNI Logging mechanism that isolates logging paths to prevent bridge bottlenecks, accompanied by async background thread execution for seamless state changes.

To get started, first deploy your Google Apps Script relay. This is identical to the upstream process:

1. Open Google Apps Script and sign in.
2. Click New project.
3. Delete the default editor content.
4. Open apps_script/Code.gs, copy everything, and paste it into Apps Script.
5. Replace this line with your own long secret:

   const AUTH_KEY = "your-secret-password-here";

6. Click Deploy -> New deployment -> Web app.
7. Set Execute as to Me and Who has access to Anyone, then click Deploy.
8. Copy the Deployment ID and keep your AUTH_KEY ready.

All GUI application source code and build tasks reside in the /cmp directory.

Before building, navigate to the /cmp folder in your terminal:

cd cmp

The desktop build automatically compiles and packages the Python proxy engine into your app resources folder.

• Run Developer Dev Server:

  ./gradlew :desktopApp:run

• Build Standalone Distribution Package:

  ./gradlew :desktopApp:packageDistributionForCurrentOS

  This generates native installers (e.g., .dmg on macOS, .msi on Windows, .deb on Linux) inside the cmp/desktopApp/build/compose/binaries directory.

• Run / Install Debug APK on Device: Make sure you have an Android device or emulator running and connected via ADB:

  ./gradlew :androidApp:installDebug

• Compile Release APK:

  ./gradlew :androidApp:assembleRelease

  The compiled APKs will be saved in cmp/androidApp/build/outputs/apk/.

• Open the /cmp/iosApp/iosApp.xcodeproj project in Xcode to build, compile, and run on the iOS Simulator or devices. Note that system VPN features on iOS are currently under simulation.

• UI Framework: Compose Multiplatform (by JetBrains)
• Dependency Injection: Koin (for multiplatform DI registration)
• HTTP Client: Ktor Client (Ktor-Darwin for iOS, Ktor-OkHttp for Android)
• Logging Engine: Timber (Android) & custom console pipes
• Embedded Python Runtimes:
  • Android: Chaquopy (embeds CPython into Gradle build flows)
  • Desktop: PyInstaller & native environment launchers
• Navigation: Jetpack Navigation Compose Multiplatform

• For the original upstream server issues and command-line support, visit the upstream repository: masterking32/MasterHttpRelayVPN.
• For GUI interface bugs, performance optimization requests, and mobile client improvements, feel free to open an issue or pull request under this fork!

This project is licensed under the MIT License — see the LICENSE file for details.