PacketRaven

PacketRaven is a command-line dashboard that retrieves location telemetry sent by high-altitude balloon payloads. The program is designed to be run during a flight and display information in a terminal user interface (TUI):

Features

retrieve location telemetry from a variety of sources, including
- https://amateur.sondehub.org
- https://aprs.fi
- a TNC-equipped radio connected via USB
- a text file containing raw APRS frames
- a GeoJSON file with point geometries and telemetry
retrieve balloon flight predictions from https://predict.sondehub.org
plot variables such as altitude and ascent rate over time
estimate landing time and location

Instructions

Follow these instructions to create a new configuration file in a text editor, or use the following simple example:

# example.yaml
callsigns:
  - W3EAX-8
connections:
  sondehub: {}
  text:
    - path: http://bpp.umd.edu/archives/Launches/NS-111_2022_07_31/APRS/W3EAX-8%20raw.txt
    - port: COM3
      baud_rate: 9600

Download an executable from the Releases page.
Open a terminal window.
Run the executable you downloaded with the start subcommand, and give it the path to your configuration file:
```
packetraven.exe start example.yaml
```

[!TIP] Add --help to any command to show usage instructions.

You should now see the user interface. Resize your terminal window or decrease the font size as needed.
The left and right arrow keys (or Tab and Shift+Tab) cycle through active tabs, and the up and down arrow keys change the current plot (or scroll through log messages).
To quit, press q or Esc.

retrieve predictions

Use predict to retrieve a balloon flight prediction:

packetraven.exe predict "2023-08-16T10:00:00" -- -79 39 5 30000 9

[!WARNING] due to a limitation in the argument parser, you must prepend all negative values with --; for instance, -79 should be -- -79