https://github.com/rubiojr/vpnflag

A little tool to display VPN country exit flag and "network speed"
https://github.com/rubiojr/vpnflag

Last synced: 3 months ago
JSON representation

A little tool to display VPN country exit flag and "network speed"

• Host: GitHub
• URL: https://github.com/rubiojr/vpnflag
• Owner: rubiojr
• License: mit
• Created: 2020-02-02T13:29:39.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-03-05T02:57:08.000Z (over 3 years ago)
• Last Synced: 2025-01-26T11:09:11.919Z (5 months ago)
• Language: Go
• Size: 57.6 MB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# VPNFlag

A little tool to display VPN country exit flag and "network speed".

Linux 🐧 only for now.

![/images/vpnflag.gif](images/vpnflag.gif)

## Usage

Run the `vpnflag` binary.

You can also use [script/install-service](/script/install-service) to create and start vpnflag via systemd as a user. This requires the `vpnflag` binary to be copied to `/usr/local/bin` first.

**Icon legend**

💀 Network unreachable.

🇪🇸 The country flag indicates the exit point, i.e. your "public" IP address.

🔴 Network speed test issues.

## Building/installing

Binaries are available in https://github.com/rubiojr/vpnflag/releases.

VPNFlag relies on https://github.com/getlantern/systray so some dependencies must be satisfied first. See their repository for instructions.

Run `go build` after satisfying deps.

## Notes

Measured network speed is based on the time it takes to make an HTTP GET request to https://api.github.com/zen. While not the best or most comprehensive way to measure "network speed", it's a good enough indication of the network performance when making simple HTTP requests, i.e. browsing the web.

## GeoIP database included

This tool includes IP2Location LITE data available from [https://lite.ip2location.com](https://lite.ip2location.com).