Skip to content

koalaauto/here-macos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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 + region code (🇺🇸 LA, 🇯🇵 TYO, 🇹🇼 TPE…). Border turns red 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 shot per change. No retry storms. 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/bikekoala/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 — free, no auth, one JSON call. Thank you. (Earlier versions used ip.guide; switched in v0.26.0 after consistent VPN-egress mislabelling.)
  • 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

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages