Overhead

Experimental: not yet tested on a real board

A satellite departure board for your desk

A small LED screen that shows what is passing over your home: the space station, China's Tiangong, Hubble. It counts down. You look up.

Every line on the board comes from one free feed. Point any screen at it.

Your board, right now

What a 64 by 32 LED panel shows for your location. It counts down every second and checks the feed every five minutes.

Next passes, 24 hours

Your feed

Point any screen at this address. It is free, needs no key, and answers in under 3 KB of JSON.

https://www.orbitalwiki.com/api/v1/overhead?lat=51.5&lon=-0.1

Build the board

Mostly jumper wires, a panel and a small board. If your board comes with loose pin strips, solder them on first (step 1). The sketch below already has your feed address in it.

Read before you build

This guide is experimental. Nobody at OrbitalWiki has built this board, and the wiring, the code and the parts list have not been tested on real hardware. To see the build guide, read the safety rules and the terms below and tick both boxes.

Safety rules

  • Power: use an enclosed, certified plug-in 5 V adapter of 4 A or more (CE, UKCA or UL marked). Join its round plug to the panel's power cable with a barrel-jack-to-screw-terminal adapter, then tighten and cover the screws. Never use an open-frame supply with bare mains screw terminals unless you are trained to work with mains electricity.
  • Feed the panel from the adapter through the panel's own power cable. Jumper wires are too thin for 4 A and can melt or catch fire.
  • Check plus and minus (red and black) before you plug in. Reversed power can destroy the panel and make it hot.
  • Never run a 5 V wire between the ESP32 and the panel, and never power the panel from a USB port. Power the ESP32 only through its own USB cable; only the data wires and one GND join the two.
  • Unplug everything before you change a wire.
  • Some boards come with loose pin strips that you must solder. A soldering iron is about 350 °C: work in a ventilated place, wear eye protection, and wash your hands after you use lead solder.
  • Do not cover the panel or the adapter, and keep them away from things that burn. Stay near a new build for its first hours, and unplug it at once if anything gets hot or smells.
  • Children build this only with an adult. Small parts can be swallowed.

Terms you accept

  • OrbitalWiki gives this guide, the code and the feed free and as is, with no promise that they are correct, complete, safe or fit for any purpose.
  • You choose the parts, you build and power the board, and you use it at your own risk. You are responsible for following these safety rules and the laws where you live.
  • As far as the law allows, OrbitalWiki and the people behind it are not liable for any damage, injury, loss or cost that comes from building or using this board, including damage to your devices or your home.
  • Nothing here limits a liability that the law does not let us limit, such as for death or personal injury caused by our own negligence, or for fraud.
  • What we do: we mark the guide as untested, we keep it honest, and we fix errors that builders report to hello@orbitalwiki.com.

If a translation differs from the English text, the English text applies. Our full terms: Terms of Service

Already run Home Assistant?

Add this sensor. Its state is the number of objects above you; the passes and the ready-made board lines are attributes for any card or e-paper screen.

configuration.yaml
# configuration.yaml
sensor:
  - platform: rest
    name: Satellites overhead
    resource: "https://www.orbitalwiki.com/api/v1/overhead?lat=51.5&lon=-0.1"
    scan_interval: 300
    value_template: "{{ value_json.above }}"
    unit_of_measurement: objects
    json_attributes:
      - passes
      - board

The feed in detail

GET /api/v1/overhead with lat and lon in degrees. Optional: ids (up to 8 NORAD numbers, default ISS, Tiangong, Hubble and BlueWalker 3), min_el, hours, limit and tz. Times are unix seconds. Limit: 2,000 requests a day per network. This is the live answer for your place:

All API endpointsHear the same sky on /listen

Where the numbers come from

Orbital elements come from CelesTrak and are propagated with SGP4 on our server; we checked the passes against Heavens-Above. The count covers every object in the OrbitalWiki catalogue with current elements. The data is under ODbL 1.0: credit OrbitalWiki and CelesTrak.

MethodologyData licence