WiFi or ISP

Free for Mac · No account · No tracking

Is it your Wi‑Fi
or your ISP?

WiFi or ISP sits in your menu bar and times your router and the internet at the same moment. When the internet slows down, it tells you in plain words which side to blame, and keeps the receipts for your ISP.

macOS 14 or later · Apple Silicon and Intel · Notarized by Apple

brew install --cask coreyhaines31/tap/wifiorisp

Using Claude Code or Codex? Paste this:
Install the macOS app "WiFi or ISP" for me…
See the full prompt · Using Claude Desktop?

Tuesday, 7:52 PM

Your call freezes mid-sentence. Again.

Your face is stuck on everyone else's screen. The Wi‑Fi icon shows full bars. Someone in the next room says the TV is buffering too. Is it the Wi‑Fi, the router, or your internet provider?

From your browser, all three look exactly the same: pages hang, calls stutter, uploads crawl. From your Mac, the way to tell them apart is to time your router and the internet at the same moment, while it's happening. That's the whole idea behind WiFi or ISP.

What you've probably tried

“The speed test says I'm fine.”

By the time you open it, the hiccup has passed. And a fast result doesn't say whether the slow part was your Wi‑Fi or your provider.

“I've restarted the router three times.”

Sometimes that helps. When the problem is past your router, it only takes the whole house offline for five minutes.

“My ISP says it's my Wi‑Fi.”

Support can't see your living room, so they start with your router. You need a log that shows your router kept answering while the internet didn't.

One question, answered with two numbers.

Every few seconds, the app times a round trip to your router and, at the same moment, one to the internet. Your router is the border: everything before it is yours, everything after it is your ISP's.

Router 4 msInternet 21 ms

Fine: WiFi and ISP both OK

Both sides answer quickly. If calls still stutter, run the lag test once: it catches the slowdown that only shows up when the line is busy.

Router 4 msInternet 186 ms

Slow: ISP, not WiFi

Your router answers right away, so the slowdown is past it. Call your ISP, and send them the report.

Router 92 msSignal weak

Slow: weak WiFi signal

Even the router is slow to answer, and the signal is weak. Move closer, or add an access point.

Router 88 msSignal excellent

Slow: WiFi or router, not ISP

Strong signal, slow router. That's a crowded channel or an overloaded router. Restart it, or change its channel.

Router answersInternet silent

Offline: ISP is down, WiFi is fine

Your home network works. The outage is upstream, and the app notes exactly when it started and ended.

Router silentInternet silent

Offline: can't reach your router

Your Mac lost the router itself. Check that it's on and its lights look normal, then move closer. Your ISP may be fine.

Install it. Wait 30 seconds. Glance up.

  1. Install itDownload the DMG and drag it to Applications, or run brew install --cask coreyhaines31/tap/wifiorisp. It's signed and notarized by Apple, so it opens without warnings.
  2. Answer the welcome window onceIt offers to show your Wi‑Fi network's name (macOS counts that as location data) and to open at login, which is on by default. On macOS 15 and later, allow Local Network access when asked: that's how it times your router.
  3. Wait about 30 secondsThe first verdict needs at least three measurements. After that it keeps watching on its own, with no window to keep open.
  4. Glance at the menu barTwo small meters sit near the clock: your router on the left, the internet on the right. When something is slow, a word appears next to them, WiFi, Router, or ISP, so you know where to look before you click.

What to try first, second, and third.

Under every verdict is a short list called What to do: the next things to try, in the order worth trying them. Each one opens the right guide, starts a test, or exports your report.

The steps fit your setup. The app recognizes your router's maker and your provider. So “restart your router” opens the guide for your brand, and “check the outage page” opens Spectrum's or Verizon's, not a search box. Twelve large US providers have their own guides; everyone else gets the general steps.

Some limits no setting can fix, and the app says so plainly when it finds one. Your plan settings add two more: a plan too small for your home, and getting much less than you pay for.

  • Your router is holding your Mac back: your Mac supports Wi‑Fi 6E, but your router tops out at Wi‑Fi 5 or older.
  • Your Wi‑Fi is slower than your plan: speed tests hit what your Wi‑Fi link can carry, while you pay for a lot more.
  • Your router can't fix lag under load: the lag builds up in your modem or at your ISP. A router with smart queueing (SQM) could keep it in check; yours has none.

A flight recorder for your connection.

Slow internet never happens while the support rep is on the phone. So WiFi or ISP logs it in the background: signal, noise, transmit rate, roaming, router and internet round trips, and every drop. Look back an hour or a month.

When you're ready to complain, export a plain-text report. It lists each outage and whether your router kept answering through it, which is the part that makes an ISP stop telling you to restart your router.

Open History (⌘H) to see 1 hour, 6 hours, 24 hours, 7 days, or 30 days, with every drop marked and whose side it was on. Keep 7, 30, or 90 days of log, and export everything as CSV if you'd rather make your own charts.

Connection report
Period: Oct 1 at 9:00 AM to Oct 8 at 9:00 AM

- Outages: 3, 47 min in total.
  During 3 of them, my router kept answering
  while nothing past it did, so the outage was
  on the ISP's side.
- Slow because of the ISP's side: 9.4%
- Slow because of my home network: 0.6%
- Typical round trip to my router: 4 ms.

Know the moment your internet drops.

Get a heads-up when the internet drops, and again when it's back, with how long it was gone. Hear when your Mac falls back to slower 2.4 GHz, or roams to an access point worse than the one it left.

Turn each one off in Settings. Reconnecting after sleep never counts as a drop.

Tests that settle the argument.

Speed

412Mbps down
38Mbps up

Measured against the nearest Measurement Lab server, a nonprofit research project. M-Lab publishes every result as open data, and the app tells you so before your first test. Runs only when you click it.

Lag under load

205RPM · Low

Lags under load: past your router (bufferbloat)

Fills your connection both ways and measures how slow round trips get, using the IETF responsiveness test. Router probes during the test show whether the queue is on your side or past it, and what to change.

Find out if you're getting the speed you pay for.

Enter the download and upload speeds on your bill in Settings → Your Plan. The app compares them with your speed tests and adds them to the report for your provider. When two or more tests average under 60% of your plan, it tells you.

It also works the other way. Tell it how your home uses the internet: people, 4K streams, gaming, calls, and big uploads. It estimates what you need, roughly 10 Mbps down per person, 25 per 4K stream, 15 more for gaming and 5 for calls. If your plan is too small, it says no router will fix that.

GeneralOpen at login, what the menu bar shows (signal in dBm, and the WiFi, Router, or ISP word), and automatic updates.
AlertsDrops and recoveries, falling back to 2.4 GHz, roaming to a weaker access point. Each one on or off.
PrivacyShow the network name, and keep history for 7, 30, or 90 days.
AdvancedPoint the lag test at another responsiveness server, including one you host yourself.

How it decides whose side is slow.

No black box. Every number below is a constant in the app's source, and the full method is in how it works on GitHub.

Three round trips at once

Each check times a TCP handshake to your router (on port 53, 80, or 443, whichever it answers), and to 1.1.1.1 and 8.8.8.8 on port 443. The faster of the two internet replies counts, so one resolver having a bad moment isn't blamed on your ISP. A handshake is exactly one round trip and carries no data. No ping, no admin password.

Wi‑Fi readings, never a scan

From macOS it reads signal and noise, transmit rate, channel, band, channel width, and Wi‑Fi generation for the network you're on. It never scans for nearby networks.

A verdict from the last few minutes

It looks at the last six checks from the last three minutes, and waits for at least three. Behind a VPN it still times the Wi‑Fi router underneath. Over Ethernet it skips the signal and compares your router with the internet.

How often it checks
SituationChecks every
Something is wrong5 seconds
Fine for under 2 minutes10 seconds
Fine for 2 to 10 minutes20 seconds
Fine for longer30 seconds
Mac asleepNot at all, and no drops counted for 30 seconds after waking
When it calls something slow
VerdictThreshold
Router is slowTypical round trip over 40 ms, or a quarter of checks lost
ISP side is slowInternet more than 100 ms slower than the router, or a quarter lost
Signal is weak−75 dBm or weaker, or under 15 dB above the noise
OfflineThe last two internet checks both lost
A dropTwo lost internet checks in a row, until the first reply

Built for calls, games, and arguments with your ISP.

On calls all day

When Zoom or Meet freezes, glance at the menu bar instead of guessing. If calls only stutter while a backup or upload runs, the lag-under-load test shows whether the queue builds up in your Wi‑Fi or past your router, and what to change.

Online gaming

Lag spikes are rarely about raw speed. The app watches round trips, not megabits, and the lag test scores responsiveness the same way Apple's networkQuality does.

Fighting with your provider

The log runs in the background, so the evidence exists before you call. Export the report: each outage, how long it lasted, and whether your router kept answering through it. Add your plan, and it shows what you're getting against what you pay for.

The family's IT person

“The Wi‑Fi is down” turns into a one-word answer. Check the history for last night, see if the Mac fell back to 2.4 GHz or roamed to a weaker access point, and fix the right thing the first time.

Working with AI agents

The wifiorisp command gives Claude Code, Codex, or a script the same verdict in JSON, with exit code 2 when something is wrong. The Claude Desktop extension answers in plain words.

Before you buy a router

Before you spend money on hardware, find out what's slowing you down: the router, the distance, or a plan that's too small.

Claude Desktop extension

Ask Claude why the internet is slow.

Add WiFi or ISP to Claude Desktop and ask in plain words: is it my Wi‑Fi or my ISP, is my ISP down, was it slow last night. Claude reads the same verdict you see in the menu bar, and can write up the report for your ISP.

The extension only reads, and never passes Claude your IP address, your router’s hardware address, or where you are. Speed and lag tests stay off unless you turn them on.

Install WiFi or ISP first. Then double-click wifiorisp.mcpb, or drag it onto Claude Desktop, and choose Install.

Let your AI agent install it

Using Claude Code, Codex, or another coding agent? Paste this in and it will install and open WiFi or ISP for you.

Install the macOS app "WiFi or ISP" for me.
If Homebrew is installed (check with `command -v brew`), run:
  brew install --cask coreyhaines31/tap/wifiorisp
Otherwise, download and install the signed DMG:
  curl -fL -o /tmp/WiFiOrISP.dmg https://github.com/coreyhaines31/wifiorisp/releases/latest/download/WiFiOrISP.dmg
  hdiutil attach -nobrowse -quiet -mountpoint /tmp/wifiorisp-dmg /tmp/WiFiOrISP.dmg
  ditto "/tmp/wifiorisp-dmg/WiFi or ISP.app" "/Applications/WiFi or ISP.app"
  hdiutil detach -quiet /tmp/wifiorisp-dmg
Then open it with: open -a "WiFi or ISP"
It's a menu bar app with no Dock icon. Tell me to look for the two small
meters near the clock, and that its welcome window asks about Location access
(only used to show the Wi-Fi network name) and opening at login.
Finally, run `wifiorisp status` (Homebrew puts it on the PATH; otherwise it's
"/Applications/WiFi or ISP.app/Contents/MacOS/wifiorisp") and tell me what it says.
Last, ask me whether future agent sessions should know about WiFi or ISP. Only if I
say yes, append this to your own global instructions file (~/.claude/CLAUDE.md for Claude Code, ~/.codex/AGENTS.md for Codex), unless it's already there, and tell me which file you changed:
  When I say the internet is slow, laggy, or dropping, run `wifiorisp status --json` to see whether it's my Wi-Fi or my ISP, and follow its nextSteps. Run `wifiorisp lag` when calls or games stutter, `wifiorisp speed` to compare with my plan, and `wifiorisp report` when I need evidence for my ISP. Ask me before running `wifiorisp speed`: M-Lab publishes each speed test, with my IP address, as open data.

Then let it figure out why the internet is slow

The app comes with a wifiorisp command, so your agent can check for itself instead of guessing. Ask in plain words: “My Zoom calls keep freezing. Use the wifiorisp command to find out whether it's my Wi-Fi or my ISP, and tell me what to fix.”

wifiorisp status    # the verdict, the numbers behind it, and what to do next
wifiorisp lag       # lag under load, and where it builds up
wifiorisp speed     # download and upload speed
wifiorisp report    # the report to send your ISP

Every command takes --json. To make it automatic, add this to your CLAUDE.md or AGENTS.md:

When I say the internet is slow, laggy, or dropping, run `wifiorisp status --json`
to see whether it's my Wi-Fi or my ISP, and follow its nextSteps. Run `wifiorisp lag`
when calls or games stutter, `wifiorisp speed` to compare with my plan, and
`wifiorisp report` when I need evidence for my ISP.
Ask me before running `wifiorisp speed`: M-Lab publishes each speed test, with my
IP address, as open data.

Using Claude Desktop instead? Add the extension. All the commands and options are in Help. Want to build it from source instead? There's a prompt for that too.

The other ways to find out, honestly compared.

Speed tests, macOS's own tools, and your router's app are all free, and each is good at something. None of them watches your router and the internet side by side, all day, and tells you in plain words whose side is slow.

WiFi or ISPSpeed testsSpeedtest, fast.comnetworkQualitybuilt into macOSWireless Diagnosticsbuilt into macOSRouter appseero, Google Home, Orbi, DecoiStat Menus
Says whether it's your Wi‑Fi or your ISPYes, in plain wordsNo, one end-to-end resultNo, one end-to-end resultNo, it's about the radioPartly: their speed test runs from the router, which leaves your Wi‑Fi outNo
Watches in the backgroundYes, every 5 to 30 secondsNo, when you run oneNo, when you run itOnly while its window is openeero runs a speed test every 1 to 3 daysYes
Wi‑Fi signalExcellent to Weak, dBm if you want itNoNoYes, detailed graphs in dBmVaries by brandYes, with signal-to-noise and link speed
Lag under load (bufferbloat)Yes, and whether it builds up before or past your routerfast.com shows loaded latencyYes, responsiveness in RPMNoNot that we foundNo
History of dropsUp to 90 days, each with whose side it was onSpeedtest keeps your past testsNoNoeero Plus has activity historyGraphs up to 28 days, and internet-down alerts
Report for your ISPYesNoNoA diagnostics file for AppleNot that we foundNo
Works with any routerYesYesYesYesOnly their own brandYes
PriceFreeFreeBuilt into macOS 12 and laterBuilt into macOSFree with the router; eero Plus, which adds activity history, is $9.99 a month$11.99 once, or with Setapp

Where speed tests win

A trusted throughput number against a huge server network, and fast.com needs no install at all. Use one when you want to know how fast. Use WiFi or ISP when you want to know whose fault slow is. (It has a speed test too, against M-Lab.)

Where macOS's tools win

networkQuality uses the same IETF responsiveness method as the lag test here, with no install. Wireless Diagnostics shows far more radio detail than any menu bar app, with scans and a packet sniffer. Neither keeps watching after you close it.

Where router apps win

They test from the router itself, which separates your provider from your Wi‑Fi better than any app on your Mac can. They also see every device on your network. They only work with their own brand, and the history is often a subscription.

Where iStat Menus wins

Everything about your Mac: CPU, memory, disks, sensors, and per-app bandwidth. It can ping and tell you the internet is down; it doesn't say why. Run both: how they compare.

Checked November 16, 2026: Speedtest by Ookla 1.29 on the Mac App Store, fast.com, Apple's networkQuality and Wireless Diagnostics pages, eero speed test and eero Plus, Google Nest Wifi, Netgear Orbi, TP-Link Deco, and iStat Menus 7.5. More: every comparison.

No tracking. No scanning. No password.

No tracking

The app has no analytics and no account, and your history stays on your Mac. It asks Cloudflare once per network which provider you’re on, to tailor its advice; otherwise it only talks to the internet for the tests you start.

Location, only for a name

macOS treats your Wi-Fi network's name as location data. Allow it and your history is labeled by network. Skip it and everything else still works.

Never scans

It reads your current connection without scanning for networks, and backs off if macOS's Wi-Fi service gets busy.

No admin rights

Round trips are timed with ordinary connections, not ping, so there's nothing to install with a password.

Every permission it asks for

  • Location: only to read your Wi‑Fi network's name. It never reads where you are.
  • Local network (macOS 15 and later): to time your router. It doesn't look for or connect to anything else.
  • Notifications: for the alerts you leave on.
  • Open at login: a standard login item, so it keeps watching after a restart. Turn it off in Settings → General.

Everything it sends over the network

  • A TCP handshake to your router, 1.1.1.1, and 8.8.8.8 every 5 to 30 seconds, with no data in it.
  • One request to Cloudflare per network to learn your provider's name, skipped on a VPN.
  • Tests you start: M-Lab for speed and Cloudflare for lag under load. M-Lab publishes every result, including your IP address, and the app tells you so before your first test.
  • An update check, which you can turn off.

What it never does

  • No analytics, no account, no crash reporter.
  • No scanning for nearby networks, and no ping or admin rights.
  • Nothing listens on the network: the wifiorisp command talks to the app through a file only your user account can open.
  • History stays in ~/Library/Application Support/WiFi or ISP/ until you export it.

Free. Source available. No account.

No subscription, no trial, no ads, no telemetry. Use it at home or at work, and read every line of how it decides.

$0Nothing to sign up for, nothing to cancel.
Source availableOn GitHub under FSL-1.1-MIT. Each release becomes MIT two years after it ships.
4 MBThe whole download. Native Swift, no Electron.
macOS 14+Sonoma or later, on Apple silicon and Intel Macs.
NotarizedSigned with Developer ID and checked by Apple, every release.
Updates itselfWith Sparkle, or through Homebrew if you installed it that way.

What's new

  • 1.3.2Nov 17, 2026

    On macOS 26, tells you to restart your Mac when it has been on long enough for new connections to start failing, before it blames your Wi‑Fi or ISP.

  • 1.3.1Nov 16, 2026

    The meters read SLOW, OK, FAST, so a quick connection swings the needles up instead of leaving them at rest.

  • 1.3.0Nov 16, 2026

    A new look: the twin-meter icon and menu bar meters, and a rebuilt menu with the verdict, the readings, and What to do.

  • Claude DesktopOct 29, 2026

    The extension: ask Claude whether it's your Wi‑Fi or your ISP.

  • 1.2.1Oct 17, 2026

    Opens at login by default, so it's watching after a restart.

  • 1.2.0Oct 13, 2026

    The wifiorisp command for Terminal, scripts, and AI agents.

Every release

Questions

Why is my Wi-Fi so slow?

Usually one of three things: a weak signal (too far from the router, or walls in the way), a crowded channel or overloaded router, or a problem past your router at your ISP. Each one looks the same from your browser. WiFi or ISP tells them apart by timing your router and the internet together.

My Mac's internet broke after weeks without a restart. Is it my Wi-Fi?

Maybe not. On macOS 26, a Mac awake for about 49.7 days without a restart can stop opening new connections: pages and uploads time out while ping still works. Only restarting the Mac fixes it. When that's the likely cause, WiFi or ISP tells you to restart your Mac before it blames your Wi-Fi or ISP. Why it happens.

What does “WiFi” mean in the verdict?

Your side of the line: your Mac's radio, the air, and your router. “ISP” means everything past the router, including your modem and the line to your provider. If your router is slow, that's on your side, even with a strong signal.

What is bufferbloat?

When an upload or download fills your connection, packets pile up in a queue and every round trip slows down. That's why video calls stutter while a backup runs. The lag-under-load test measures it and says whether the queue is in your Wi-Fi or router, or past it. Turning on Smart Queue Management (SQM) on your router usually fixes it.

What do dBm and ms mean?

You don't need to know: the app says Excellent, Fast, or Slow. If you're curious, dBm is radio signal strength (−30 is as strong as it gets, −80 barely works) and ms is milliseconds, how long a reply takes (your router should answer in a few). Turn on the number in the menu bar in Settings if you like it.

Does it run speed tests all the time?

No. The background checks are single tiny round trips, every 5 to 30 seconds. Speed and lag tests only run when you click them.

Why does it ask for Location?

Only to show your Wi-Fi network's name, which macOS treats as location data. The app never asks where you are. Say no and it shows “Unknown network”.

Does it work over Ethernet or a VPN?

Yes. On a cable it skips the signal readings and still compares your router with the internet. With a VPN on, it still measures the Wi-Fi network underneath.

How is this different from a speed test?

A speed test measures how much your connection carries, end to end, at the moment you run it. WiFi or ISP times your router and the internet at the same moment, all day, so it can say which side is slow, including the times you weren't watching. It has a speed test too, for checking what you get against your plan.

Does it use much battery?

No. The background checks are three tiny connections every 5 to 30 seconds, it never scans for networks, and it stops while your Mac sleeps. When I measured it in November 2026, it used under 0.15% of one CPU core.

Which Macs does it run on?

macOS 14 Sonoma or later, on Apple silicon and Intel. It's signed and notarized by Apple, and it updates itself with Sparkle; if you installed it with Homebrew, brew upgrades it.

How do I uninstall it?

Turn off Open at login in Settings, quit it from its menu, and drag it from Applications to the Trash. To remove its history and settings too, run brew uninstall --zap --cask wifiorisp, or delete the WiFi or ISP folder in ~/Library/Application Support.

Is it really free?

Yes. The source is on GitHub under the Functional Source License, which turns into the MIT license two years after each release.

Next time it's slow, know who to call.

brew install --cask coreyhaines31/tap/wifiorisp

Corey Haines
Why it exists

When my internet got slow, I never knew who to blame. Speed tests gave me one number, and network tools talked in dBm and milliseconds that meant nothing to me. I just wanted to know whether to restart my router or call my ISP. So I built the app I wanted: it watches both sides all the time and tells me in plain words which one is slow. And it's free.

Corey Haines, maker of WiFi or ISP and more free Mac apps