Omahub
← All plugins
Y

Flight Radar

by yuters

Live aircraft overhead with short-horizon flyby forecasts, an overhead badge, and notifications. Works without an account.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
0a984a8
Scanned
2 weeks ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
0a984a8
Reviewed
2 weeks ago

The plugin is a straightforward flight-radar widget: it fetches aircraft data from OpenSky and uses a small shell helper to locate the user when no coordinates are configured. I found no obfuscation, persistence, destructive commands, or credential exfiltration; the only notable point is that the default IP-geolocation fallback sends the user's IP to third-party services, which the README discloses.

  • When latitude/longitude are not set, locate queries geojs.io, ipinfo.io, and ipapi.co with the user's IP address; this is disclosed in the README but is still a third-party privacy disclosure.
  • locate also probes local GPS/GNSS sources (gpsd, ModemManager, /dev/gnss*) and caches the resolved location under /tmp if XDG_RUNTIME_DIR is unset, with default file permissions.
  • OpenSky credentials, if entered, are read from ~/.local/state/omarchy/settings/flight-radar.json and sent only to OpenSky's token endpoint; the cached token is stored with 0600 permissions.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/yuters/omarchy-flight-radar --enable
Widgets #bar #quickshell #system

Flight Radar — an Omarchy bar plugin

Live aircraft overhead and short-horizon flyby forecasts, fed by the OpenSky Network.

A radar glyph sits in your bar. It carries a count badge when an aircraft is overhead, and can raise a desktop notification as one arrives. Clicking it opens a round scope with contacts drawn as heading triangles, in the colours of your active Omarchy theme; clicking a contact opens it on the OpenSky flight map. Stable inbound tracks are forecast up to ten minutes ahead, with their estimated time and distance at closest approach shown in the contact list. An advance alert is raised as one is predicted to arrive, followed by a prompt notification when it enters the overhead radius. Advance alerts can be turned off in panel settings.

Flight Radar

No account needed. It works out of the box on OpenSky's anonymous tier, and with no coordinates configured it finds an approximate centre from your IP address. Both can be improved from the panel's own settings — press S while it is open — but neither is required.

Flyby forecasts use the aircraft's current speed and heading. They are deliberately short-range estimates, and are withheld when the position is stale, motion data is missing, or the heading has changed significantly between updates.

Install

omarchy plugin add https://github.com/yuters/omarchy-flight-radar
omarchy plugin enable yuters.flight-radar right

Uninstall

omarchy plugin disable yuters.flight-radar
omarchy plugin remove yuters.flight-radar

Attribution and terms

This plugin uses data from the OpenSky Network. Their terms of use ask that any publication built on that data cite:

Bringing up OpenSky: A large-scale ADS-B sensor network for research

Matthias Schäfer, Martin Strohmeier, Vincent Lenders, Ivan Martinovic, Matthias Wilhelm

ACM/IEEE International Conference on Information Processing in Sensor Networks, April 2014

and, to refer to the site itself, The OpenSky Network, opensky-network.org.

The data is licensed for non-profit research and education. Commercial or for-profit use needs a written licence from OpenSky — contact contact[at]opensky-network.org.

OpenSky also blocks some IP ranges, cloud providers among them, in response to misuse; if the radar cannot reach the API from a hosted environment, that is expected and should be respected rather than worked around.

Credits

  • Scope design ported from micro-radar by Anthony Sturdy
  • Aircraft data from the OpenSky Network, cited above
  • Flight map links go to OpenSky's tar1090 instance by wiedehopf
  • Built for Omarchy by DHH and contributors

License

MIT — see LICENSE.