Omahub
Sign in with GitHub
← 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
Install
$ omarchy plugin add https://github.com/yuters/omarchy-flight-radar --enable
Widgets #bar #quickshell

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.