Skip to content

Run the APRS map and tmux demo

This demonstration opens the APRS map with seven invented packets from five fictional stations near Mount Rainier. It uses the project's map renderer and locally built geography packs. The tmux version adds a shell pane and separate Map, Packets, and Shell windows.

The APRS map and packet panel above a shell pane in the tmux demonstration

Laptop capture from 4 November 2026. The station positions and packet contents are fictional. The map combines public geography from OpenStreetMap, USGS, Natural Earth, and NOAA. Map data © OpenStreetMap contributors.

Use Python 3.11 or newer and a terminal with RGB color support. The tmux workspace also requires tmux. Allow at least 100 columns by 34 rows for the standalone map, or 120 columns by 44 rows for the workspace pictured above.

Open the map

First follow Download and build offline maps, including make maps-terrain. Then, from the repository root, run:

python3 tools/docs/aprs_map_preview.py --maps pocket/shell/vendor/packet-console/maps --packets

The viewer reads the locally built geography packs and generates the station reports in memory. It runs entirely offline. The @ marker follows the selected packet's position; the other station positions use *.

Action Control
Show or hide the packet panel Press p.
Move focus between panels Press Tab.
Select a packet Focus the packet panel, then use Up or Down.
Pan the map Focus the map, then use the arrow keys.
Zoom in or out Press + or -.
Show or hide the selected packet's inspector Press x.
Toggle terrain or roads Press t or r.
Close the standalone viewer Press q.

Open the tmux workspace

After closing the standalone viewer, run:

python3 tools/docs/tmux_preview.py --maps pocket/shell/vendor/packet-console/maps

The launcher creates a temporary tmux server using the project's keyboard bindings and appearance. Map starts with the packet panel open and a shell beneath it. Packets contains the standalone packet inspector; Shell provides another command prompt.

Press Ctrl-B, release it, then press 0, 1, or 2 to select Map, Packets, or Shell. Return to Map to continue with the same map position and packet selection. Finish with Ctrl-B followed by d; the launcher closes its temporary server and removes its configuration.

The APRS journal entry shows these interactions in a recording and explains how the original radio workspace developed. The map build guide describes the geography formats and preparation tools. The map fixture and tmux launcher contain the complete demonstration setup.