Skip to content

Starchorus 0.1.0

Pre-release
Pre-release

Choose a tag to compare

@starchorus-dev starchorus-dev released this 13 Oct 11:19
· 231 commits to main since this release

Starchorus 0.1.0: the first release.

Starchorus is a strictly passive Wi-Fi observation tool for the Hak5 WiFi Pineapple Pager: it
receives and never transmits. A POSIX shell collector on the Pager reads what is on the air anyway
and writes starchorus.json. A self-contained HTML page draws the radio environment from it as a
slowly turning night sky: the device at the centre, access points as stars (distance = signal
strength), clients as satellites, band as colour, encryption as a ring.

Included

  • starchorus-collect.sh: the collector (POSIX/BusyBox, read-only)
  • starchorus.html: the visualisation, a single file with no external dependencies, with a demo mode
  • starchorus-display.sh: an overview on the Pager's own display
  • starchorus-serve.sh: a small fallback server
  • library/user/reconnaissance/starchorus/: the payload, with its menu and settings
  • INSTALL.md: step-by-step installation on macOS, Linux and Windows

The page is served on the Pager's management address only (USB-C and management Wi-Fi) by default.
Checked on a Pager with firmware 24.10.1.

Licence: GPL-3.0-or-later. The embedded font is under the SIL Open Font License 1.1.

Hak5, WiFi Pineapple and WiFi Pineapple Pager are trademarks of Hak5 LLC. Starchorus is an independent project and is not affiliated with, sponsored or endorsed by Hak5.