1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
<div align="center">
# FoxyVPN-MultiAcc
> Multi-account mod of [Vauth/FoxyVPN](https://github.com/Vauth/FoxyVPN) (v1.0.6, MIT) with a rebuilt
> Pixel-style UI. Created by **muse**. Original work © 2026 Vauth — see LICENSE.
# FoxyVPN - Unofficial Firefox VPN client
<p align="center">
<img src="https://i.ibb.co/8D9KdmNk/6a07263d16c0.png" alt="FoxyVPN Logo" width="150"/>
</p>
*FoxyVPN signs in with a Firefox account, obtains a proxy pass from Mozilla's
Guardian service, and carries the whole device's traffic through Firefox VPN's
Fastly edge over an HTTP/2 tunnel. It is a native Kotlin app with a
Jetpack Compose (Material 3) UI.*
</div>
<br>
## 🔎 Features
- **System-wide VPN**
- **Firefox account sign-in**
- **Multiple Servers**
- **Split tunneling**
- **Private DNS by default**
- **Encrypted DNS (DNS over HTTPS)**
- **Upstream proxy chaining**
- **Proxy-only mode**
- **Dark / light / follow-system theme**
- **Exit verification**
- **In-app logs**
<br>
## 📸 Screenshots
<div align="center">
<img src="screenshots/home-connected.jpg" alt="Home — Connected" width="30%">
<img src="screenshots/settings-interface.jpg" alt="Settings — Interface" width="30%">
<img src="screenshots/home-disconnected.jpg" alt="Home — Disconnected" width="30%">
</div>
<br>
## 🚀 How to use?
1. **Get a Firefox account.** If you do not have one, create it for free at
[accounts.firefox.com](https://accounts.firefox.com/signup).
2. **Install the APK** from the [Releases](https://github.com/vauth/foxyvpn/releases)
page.
3. **Sign in** with that account's email and password.
4. **Pick a location** and tap the power button.
> [!NOTE]
> **No subscription is required.** FoxyVPN runs on the free **50 GB of monthly
VPN traffic Mozilla includes with a Firefox account** for browser users, which
is the same allowance the Firefox browser's built-in VPN uses. Once the
allowance is used up for the month, connections stop working until it resets.
<br>
## 🗃 Requirements
- Android 8.0 (API 26) or newer
- JDK 17
- Android SDK 35 and NDK `26.1.10909125`
- `git` on `PATH`
<br>
## ⚙️ Build
* #### Clone Repository:
```bash
git clone https://github.com/vauth/foxyvpn.git
cd foxyvpn
```
* #### Build and Install:
```bash
gradle :app:assembleRelease --no-daemon
```
<br>
### 📝 To-Do List
The project is on test phase so not much yet.
- [x] Improve stability.
- [x] Better Logo.
- [ ] HTTP/3 implementation (Not Planned Yet).
<br>
## ✍️ Acknowledgements
- [firefox-vpn-client](https://github.com/UjuiUjuMandan/firefox-vpn-client) - the Go reference client this app is a port of
- [hev-socks5-tunnel](https://github.com/heiher/hev-socks5-tunnel) - the native tun2socks engine
- [Conscrypt](https://github.com/google/conscrypt) - ALPN-capable TLS on every supported API level
<br>
## 🛠 Contributing
Contributions are welcome! Feel free to submit a pull request or report an issue.
<br>
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
