https://github.com/ch00k/mullvad-compass
Find the best Mullvad VPN server to connect to
https://github.com/ch00k/mullvad-compass
benchmark latency mullvad mullvad-vpn server vpn
Last synced: 3 months ago
JSON representation
Find the best Mullvad VPN server to connect to
- Host: GitHub
- URL: https://github.com/ch00k/mullvad-compass
- Owner: Ch00k
- License: unlicense
- Created: 2025-11-17T09:42:55.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-29T19:55:10.000Z (5 months ago)
- Last Synced: 2026-01-28T18:38:46.580Z (4 months ago)
- Topics: benchmark, latency, mullvad, mullvad-vpn, server, vpn
- Language: Go
- Homepage:
- Size: 111 KB
- Stars: 14
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mullvad-compass
Find Mullvad VPN servers with the lowest latency at your current geographic location.
> [!NOTE]
> This is a rewrite of [mullvad-closest](https://github.com/Ch00k/mullvad-closest), offering more features, better
> performance, and a single binary distribution with no runtime dependencies.
## Motivation
Mullvad VPN has a large number of servers worldwide. If you are in a country where Mullvad VPN servers are present, you
are in luck - simply select the country and Mullvad VPN app will usually pick the best server for you. However, it is
not as straightforward if you are in a country without Mullvad servers. When in Bosnia and Herzegovina, do you connect
to servers in Croatia, Serbia, or Hungary? When in Iceland, do you connect to servers in Norway, UK, or Canada?
**mullvad-compass** helps you answer these questions by finding the best Mullvad VPN servers at your current location.
## Features
- Finds the single best or multiple closest Mullvad VPN servers
- Filters by distance threshold and anti-censorship protocol
- Measures actual latency via ICMP ping
- Supports IPv4 and IPv6
- Achieves subsecond performance thanks to concurrent pings
- Shows your current location based on Mullvad's API
- Supports Linux, macOS, and Windows
## Installation
Download pre-built binaries from the [releases page](https://github.com/Ch00k/mullvad-compass/releases).
### Mullvad VPN
The tool reads Mullvad's `relays.json` file from the platform-specific location:
- **Linux**: `/var/cache/mullvad-vpn/relays.json`
- **macOS**: `/Library/Caches/mullvad-vpn/relays.json`
- **Windows**: `C:/ProgramData/Mullvad VPN/cache/relays.json`
This file is created when you install the Mullvad VPN app.
## Usage
Run without options to find the single best (lowest latency) server:
```
$ mullvad-compass
Your location: Dresden, Germany
203.0.113.42
Best server: Prague, Czech Republic
cz-prg-wg-201 (178.249.209.162)
9.78 ms, 156 km away
```
Find multiple servers within 200 km, sorted by latency (lowest first):
```
$ mullvad-compass --max-distance 250
Country City Distance (km) Hostname IP Latency (ms)
-------------- ------ ------------- ------------- --------------- ------------
Czech Republic Prague 156 cz-prg-wg-201 178.249.209.162 9.78
Czech Republic Prague 156 cz-prg-wg-202 178.249.209.175 13.01
Czech Republic Prague 156 cz-prg-wg-102 146.70.129.130 13.94
Germany Berlin 238 de-ber-wg-007 193.32.248.75 15.86
Germany Berlin 238 de-ber-wg-001 193.32.248.66 15.88
Germany Berlin 238 de-ber-wg-005 193.32.248.70 15.89
Germany Berlin 238 de-ber-wg-008 193.32.248.74 15.91
Germany Berlin 238 de-ber-wg-003 193.32.248.68 15.93
Germany Berlin 238 de-ber-wg-004 193.32.248.69 15.95
Germany Berlin 238 de-ber-wg-006 193.32.248.71 15.95
Germany Berlin 238 de-ber-wg-002 193.32.248.67 15.99
```
All options can be viewed with `--help`:
```
$ mullvad-compass --help
mullvad-compass 0.0.3
Find Mullvad VPN servers with the lowest latency at your current location.
USAGE:
mullvad-compass [OPTIONS]
MODES:
Best Server Mode (default): Shows your location and the single best server.
Activated when running without filter options.
Table Mode: Shows all matching servers in a table, sorted by latency.
Activated by using any filter option (-m, -a, -d, -6).
FILTER OPTIONS (Table Mode):
-m, --max-distance KM Maximum distance in km from your location (default: 500, range: 1-20000)
-a, --anti-censorship TYPE Filter servers by anti-censorship type (lwo, quic, shadowsocks)
-d, --daita Filter servers with DAITA enabled
-6, --ipv6 Use IPv6 addresses for pinging
PERFORMANCE OPTIONS:
-t, --timeout MS Ping timeout in milliseconds (default: 500, range: 100-5000)
-w, --workers COUNT Number of concurrent ping workers (default: 25, range: 1-200)
OTHER OPTIONS:
-l, --log-level LEVEL Set log level (debug, info, warning, error; default: error)
-h, --help Show this help message
-v, --version Show version information
```