Italiano sotto / Italian below
A macOS menu bar app that periodically pings a host of your choice and shows the result right next to the clock: a wifi-style signal bars icon plus latency and packet-loss percentage (e.g. ▂▄▆█ 9ms (0%)).
Built to replace a ~10-year-old third-party menu bar widget that macOS was about to stop running.
Grab the latest .dmg from the Releases page, open it, and drag PingSentry into Applications.
Not notarized yet: since this isn't signed with a paid Apple Developer ID, macOS will flag it as being from an unidentified developer on first launch. To open it: right-click (or Control-click) PingSentry.app in Applications → Open → confirm in the dialog. You only need to do this once.
- Swift + SwiftUI, using
MenuBarExtra(macOS 14+). - Ping runs as a single long-lived
ping -i <interval> <host>process for the whole monitoring session (not one process per ping — that used to inflate every latency reading with a "cold first packet" cost). Output is parsed line by line; packet loss is detected from gaps inicmp_seq. - Menu bar label, notifications, session/lifetime stats (total pings, success/failure count and %, average/fastest/slowest latency), launch-at-login, and an in-app language picker are all configurable from Settings.
swift build
swift run
./Scripts/test.sh # Run automated test suiteswift run launches the app as a plain process (you'll also see a Dock icon, which the packaged .app hides via LSUIElement). Login item and notifications only work from a packaged .app with a bundle identifier — swift run alone can't exercise those two features.
To build a distributable .app bundle (ad-hoc signed, not notarized):
./Scripts/build_app.shSources/PingSentry/PingSentryApp.swift— app entry point, menu bar label, window scenes.Sources/PingSentry/PersistentPinger.swift— long-lived ping process runner and session manager.Sources/PingSentry/PingOutputParser.swift— pure parser for ping output and packet loss gap detection.Sources/PingSentry/PingMonitor.swift— ping loop orchestration, rolling packet-loss window, sleep/wake handling, notifications.Sources/PingSentry/PingStats.swift— session and in-memory debounced lifetime counters.Sources/PingSentry/Localization.swift— in-app language override (independent of the macOS system language).Sources/PingSentry/Resources/*.lproj/— translated strings.Sources/PingSentry/MenuContentView.swift,SettingsView.swift,AboutView.swift,StatsView.swift— UI.Tests/PingSentryTests/— automated unit tests covering parser, statistics, and quality indicators.
Supported languages: English, Italian, French, German, Spanish, Portuguese, Polish, Romanian, and Simplified Chinese. The in-app language picker (Settings → Language) defaults to "System Language" (auto-detected from macOS, falling back to English) but can be overridden per-user regardless of the OS setting.
All translations were written by an AI assistant rather than reviewed by a native speaker. Confidence is reasonably high for French, German, Spanish, and Portuguese; Polish, Romanian, and Simplified Chinese are the least certain and would most benefit from a native speaker's review. If you speak one of these languages and spot an awkward phrasing or outright mistake, contributions are very welcome — the relevant files are the .strings tables under Sources/PingSentry/Resources/<language-code>.lproj/Localizable.strings; open a pull request or an issue with the fix.
Not yet notarized. Plan: a notarized DMG published via GitLab/GitHub Releases, which needs an Apple Developer ID account to be set up separately.
MIT — do whatever you want with it, just keep the copyright notice.
PingSentry is free. If you find it useful, feel free to buy me a coffee on Ko-fi — no obligation at all.
App per la barra menu di macOS che esegue un ping periodico verso un host a scelta e ne mostra il risultato accanto all'orologio: un'icona a barre stile segnale wifi più latenza e percentuale di pacchetti persi (es. ▂▄▆█ 9ms (0%)).
Nata per sostituire un vecchio widget di terze parti (~10 anni) che macOS stava per smettere di far funzionare.
Scarica l'ultima .dmg dalla pagina Releases, aprila e trascina PingSentry nella cartella Applicazioni.
Non ancora notarizzata: non essendo firmata con un account Apple Developer ID a pagamento, al primo avvio macOS la segnala come proveniente da uno sviluppatore non identificato. Per aprirla: tasto destro (o Control-clic) su PingSentry.app in Applicazioni → Apri → conferma nella finestra di dialogo. Serve una volta sola.
- Swift + SwiftUI, con
MenuBarExtra(macOS 14+). - Il ping gira come un unico processo
ping -i <intervallo> <host>per tutta la sessione di monitoraggio (non un processo per ogni ping — cosa che gonfiava ogni misura di latenza con il costo del "primo pacchetto a freddo"). L'output viene letto riga per riga; i pacchetti persi si rilevano dai buchi nella sequenzaicmp_seq. - Etichetta in barra, notifiche, statistiche di sessione/lifetime (ping totali, conteggio e % di successi/fallimenti, latenza media/minima/massima), avvio automatico al login e selettore di lingua sono tutti configurabili dalle Impostazioni.
swift build
swift run
./Scripts/test.sh # Esecuzione suite di test automaticiswift run avvia l'app come processo semplice (comparirà anche un'icona nel Dock, assente invece nel bundle .app grazie a LSUIElement). Avvio automatico al login e notifiche funzionano solo con un .app pacchettizzato con un bundle identifier — swift run da solo non basta per queste due funzionalità.
Per costruire un bundle .app distribuibile (firmato ad-hoc, non notarizzato):
./Scripts/build_app.shSources/PingSentry/PingSentryApp.swift— entry point, etichetta in barra, finestre.Sources/PingSentry/PersistentPinger.swift— runner del processo ping persistente e gestione delle sessioni.Sources/PingSentry/PingOutputParser.swift— parser puro per l'output di ping e rilevamento perdita pacchetti.Sources/PingSentry/PingMonitor.swift— orchestrazione del ciclo di ping, finestra di calcolo della perdita, gestione sleep/wake, notifiche.Sources/PingSentry/PingStats.swift— contatori di sessione e lifetime con cache in memoria e debouncing.Sources/PingSentry/Localization.swift— override della lingua a livello di app (indipendente dalla lingua di sistema di macOS).Sources/PingSentry/Resources/*.lproj/— stringhe tradotte.Sources/PingSentry/MenuContentView.swift,SettingsView.swift,AboutView.swift,StatsView.swift— interfaccia.Tests/PingSentryTests/— test unitari automatici su parser, statistiche e indicatori di qualità segnale.
Lingue supportate: italiano, inglese, francese, tedesco, spagnolo, portoghese, polacco, rumeno e cinese semplificato. Il selettore di lingua nell'app (Impostazioni → Language) parte da "System Language" (rilevata automaticamente da macOS, con fallback all'inglese) ma può essere forzato dall'utente indipendentemente dall'impostazione del sistema operativo.
Tutte le traduzioni sono state scritte da un assistente IA, non riviste da un madrelingua. La confidenza è ragionevolmente alta per francese, tedesco, spagnolo e portoghese; polacco, rumeno e cinese semplificato sono le meno certe e trarrebbero più beneficio da una revisione di un madrelingua. Se parli una di queste lingue e noti una frase innaturale o un errore, i contributi sono benvenuti — i file interessati sono le tabelle .strings sotto Sources/PingSentry/Resources/<codice-lingua>.lproj/Localizable.strings; apri una pull request o una issue con la correzione.
Non ancora notarizzata. Piano: una DMG notarizzata pubblicata via GitLab/GitHub Releases, che richiede un account Apple Developer ID da configurare a parte.
MIT — fanne quello che vuoi, basta mantenere la nota di copyright.
PingSentry è gratis. Se ti torna utile, sentiti libero di offrirmi un caffè su Ko-fi — nessun obbligo.