FoxyVPN - Unofficial Firefox VPN Client

FoxyVPN is a modern, privacy-focused Android client for Mozilla's Firefox VPN service. Powered by a customized sing-box core, it connects directly to Mozilla's global Fastly edge network using high-performance MASQUE protocol with HTTP/1.1, HTTP/2, and HTTP/3 support.

✨ Features

Core & Privacy

• Firefox Account Integration
• System-Wide VPN Tunneling
• Split Tunneling (Per-App Selection)
• IP Protocol Modes (Dual-Stack, Prefer IPv4/IPv6, IPv4/IPv6-Only)
• Local HTTP / SOCKS5 Proxy Server & LAN Sharing
• Custom & Bootstrap DNS-over-HTTPS (DoH)
• Local Network Bypass
• Proxy-Only Mode

Performance & Censorship Resistance

• MASQUE over HTTP/1.1, HTTP/2, and HTTP/3 (QUIC)
• TLS Fragmentation (Record & Packet)
• uTLS Fingerprint Emulation
• Upstream Proxy Chaining
• Custom Edge Override
• Multiplexing & Concurrency Controls
• Custom Tunnel MTU
• Automatic Connection Recovery

User Experience & System Integration

• Real-Time Traffic & Latency Diagnostics
• Public & Exit IP Detection
• Global Server Locations
• Quick Settings Tile & Home Screen Widget
• Release Update Checks & Notifications
• Diagnostic Logging & Export

📸 Screenshots

🚀 Getting Started

1. Get a Firefox account: If you don't already have one, create an account at accounts.firefox.com.
2. Download & Install: Grab the latest APK matching your device (arm64-v8a, armeabi-v7a, or universal) from the Releases page.
3. Sign In: Tap "Sign in with Firefox" to authenticate via the in-app browser.
4. Connect: Choose a server location and tap the power button.

Note

Access, entitlement, quota, and geographic availability are controlled by Mozilla. FoxyVPN connects directly to official endpoints and respects account quotas.

🛠 Building from Source

Prerequisites

• JDK 17
• Android SDK (API 35, Build-Tools 35.0.0)
• Gradle 8.10.2

Build Instructions

1. Clone the repository:

   git clone https://github.com/Vauth/FoxyVPN.git
   cd FoxyVPN

2. Download and verify the pinned sing-box core (libbox.aar):

   mkdir -p app/libs
   curl -L -o app/libs/libbox.aar https://github.com/Vauth/sing-box/releases/download/v1.0.0-masque/libbox.aar
   echo "a6a28c7f3cb53f4251d1578f4772f79831395503fdbf91920c6c1e33cc80281c  app/libs/libbox.aar" | sha256sum --check --strict

3. Build the APKs:

   gradle :app:assembleDebug

   Output APKs will be located in app/build/outputs/apk/debug/.

✍️ Acknowledgements

• sing-box - the universal proxy platform
• firefox-vpn-client - the Go reference client

🛠 Contributing

Contributions are welcome! Feel free to submit a pull request or report an issue.

📄 License

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