Skip to content

Repository files navigation

Ping Warden

Ping Warden

Stop AWDL from reactivating during latency-sensitive games and calls.

event-driven protectionmacOS 13+Intel and Apple siliconsigned and notarized

Download License Donate on Buy Me a Coffee

InstallHow it worksPrivacyDocumentationBuild


Ping Warden is a free, open source macOS menu bar app for latency-sensitive games, calls, and cloud streaming. It watches Apple Wireless Direct Link (AWDL), the network interface used by AirDrop, AirPlay, Handoff, and other nearby-device features, and keeps that interface down while Ping Protection is active.

Ping Warden 3 dashboard showing a Latency Session, live latency, jitter, probe failures, and ping history

The tradeoff

Ping Protection temporarily makes AirDrop, AirPlay, Handoff, and other AWDL-dependent features unavailable on your Mac. Turn protection off when you need them, or use the 10-minute pause from the menu bar. Ping Warden restores AWDL when protection stops and during its removal flow.

That tradeoff is the point of the app. You choose when a latency-sensitive game or call matters more than nearby-device features.

Why this exists

Running sudo ifconfig awdl0 down once is not enough because macOS can bring AWDL back up within seconds. A timer-based script reacts after the interface is already active, which still leaves time for channel switching to affect the connection.

How it works

Ping Warden uses a privileged helper that waits for kernel route and interface events. When macOS tries to raise awdl0 while Ping Protection is on, the helper takes it back down and increments an intervention counter. The dashboard puts that counter next to live latency, jitter, probe failures, and history so you can see what happened on your own network.

Install, approve, and verify

1. Install

Download the latest DMG from Releases, open it, and drag Ping Warden to /Applications. Launch the copy in Applications.

2. Approve the helper

Click Set Up and Turn On Protection, then approve Ping Warden in System Settings when macOS asks. The helper needs this one-time approval because changing the AWDL interface requires elevated access.

3. Turn on Ping Protection and verify it

Enable Ping Protection from the menu bar. Open the dashboard and confirm that protection is active. The dashboard will show live latency and count each time the helper blocks macOS from reactivating AWDL.

The Quick Start guide covers first-run setup and the optional automation features.

What Ping Warden includes

Feature What it does
Ping Protection Keeps awdl0 down with an event-driven privileged helper
Live dashboard Tracks latency, jitter, probe failures, history, and helper interventions
Game Mode auto-detect Turns protection on for recognized fullscreen games after you grant Screen Recording access
Quick pause Restores nearby-device features for 10 minutes, then returns to your previous protection state
Control Center widget Provides a system toggle on macOS 26 or newer in signed release builds
Diagnostics export Creates a local support snapshot that you can review before sharing
Automatic updates Uses Sparkle and signed update metadata to deliver new releases

Apple added third-party Mac controls to Control Center in macOS Tahoe 26, which is why the widget has a newer requirement than the rest of the app.

Ping targets include common public services, discovered GeForce NOW regions, your network gateway, and targets you add yourself.

Privacy

Latency history, protection state, settings, and intervention counts stay on your Mac. Ping Warden does not send usage analytics.

The app makes a few narrow outbound requests:

  • Sparkle checks the public appcast for updates.
  • The dashboard checks status.geforcenow.com to discover GeForce NOW target hostnames.
  • Anonymous crash reporting is off by default. If you opt in under Settings > Advanced > Privacy, reports exclude IP addresses, ping targets, network breadcrumbs, performance traces, and app-lifecycle tracking.
  • TCP latency probes connect only to the target you select or ask Ping Warden to choose.

Diagnostics exports are written locally. Ping Warden never uploads them for you.

Donate to Ping Warden

The dashboard tells you how often Ping Warden had to step in. If you have found the app useful, you can donate on Buy Me a Coffee to help cover signing, testing, and release costs.

Ping Warden remains free and open source whether you donate or not.

Documentation

Build from source

git clone https://github.com/oliverames/ping-warden.git
cd ping-warden
swift test
open PingWarden/PingWarden.xcodeproj

The app requires macOS 13 or newer. Configure signing for the app, helper, and widget targets before running from Xcode. The full helper-registration flow only works when the built app is installed in /Applications; non-helper UI work can run from Xcode.

Credits

License

Ping Warden is available under the MIT License. Copyright (c) 2025-2026 Oliver Ames.


Donate on Buy Me a Coffee

Built by Oliver Ames in Vermont • GitHubLinkedInBluesky

About

macOS menu bar app that blocks AWDL during latency-sensitive games and calls, with live network metrics, Protected Sessions, signed updates, and a Control Center toggle.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages