Skip to content

Latest commit

 

History

60 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Here

Which country are you on the internet right now?

A tiny macOS menu bar app that answers that question, always. Flip a VPN, hop WiFi, toggle Clash — Here tells you at a glance where your traffic actually leaves from.

Here popover — flag, IP, map, history, latency, throughput

What you see

The pill lives in your menu bar: flag + a two-letter region tag (🇺🇸 CA, 🇯🇵 TK, 🇸🇬 SG…). The outline switches to a dashed border the moment the latency probe says the network's actually broken. When egress can't be verified (airplane mode, IP service unreachable), the pill flips to a random flag + OO — an honest "I don't know" instead of a stale lie.

Click the pill for the popover above:

  • Location — big copyable IP, mini Maps preview, ASN + ISP, local time.
  • History — recent egress changes as a flag chain with "time ago" labels.
  • Latency — rolling 30-probe bar, color-coded green / yellow / orange / red.
  • Throughput — on-demand download speed test (Cachefly / Cloudflare / custom URL).

Smart enough to keep up

  • Catches every meaningful network change — WiFi hops, VPN up/down, Clash "system proxy" flips. The widget rechecks on a 5-second loop (30s while the display is asleep), so a node switch lands in your menu bar within one tick.
  • One lookup per change. No retry storms — a single attempt per tick (at most one fallback hop if the primary provider is down). Fails fast, respects your sanity.
  • Flag follows the geographic country, not the ASN country. A VPN registered in HK but serving a Taiwan node shows 🇹🇼, not 🇭🇰.
  • Self-updating. Daily check against GitHub releases (Never / Once a day / Once a week, your call) — when there's a new build it nudges you with the release notes and a one-click jump to the download.

Install

Grab the latest .dmg from Releases → drag Here into Applications → first launch: right-click → Open (the build is unsigned).

  • macOS 15 Sequoia or later
  • Apple Silicon + Intel — universal binary, any Mac that supports Sequoia

Build from source

git clone https://github.com/koalaauto/here-macos.git
cd here-macos
open Here.xcodeproj       # Cmd-R to run, Cmd-U to test

Or CLI:

xcodebuild -project Here.xcodeproj -scheme Here build
xcodebuild -project Here.xcodeproj -scheme Here test

Credits

  • IP + location data from ipwho.is (primary) and ip.guide (automatic fallback since v0.33.0) — both free, no auth, one JSON call each. Thank you.
  • Flag art from flagcdn.com — rectangular PNGs, public-domain.

Architecture, conventions, and gotchas live in CLAUDE.md.

License

MIT

About

A tiny native macOS menu bar widget that shows your current public IP's country and region at a glance, with a rich popover for details. Swift 6 + SwiftUI + AppKit, zero third-party dependencies.

Topics

Resources

Stars

46 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages