LXST Client

Single-file Python application for managing LXST Channel connections via Reticulum Network (RNS) and LXMF protocols. Supports CLI and Whisplay HAT GUI modes.

Running (CLI mode, default)

python client.py [-c CONFIGDIR] [-w WHITELIST]

Options: -c, --config : config directory (default: ~/.lxst-client or /etc/lxst-client) -w, --whitelist : path to bridge_whitelist.json -v, --verbose : enable debug logging --rnsconfig : alternative Reticulum config directory --whisplay, -W : enable Whisplay HAT GUI mode

Running (Whisplay GUI mode)

python client.py -W [-c CONFIGDIR] [-w WHITELIST]

CLI Commands

Inside the interactive client: d Discover channels from whitelist l List discovered channels Connect to channel at index NUM (1-based) h / ? Show help q Quit

Whisplay GUI Controls

Channel list (STATE_READY)

Short press (<1s) Cycle to next channel in list Long press (>=1s) Call the selected channel

In call — Push-to-Talk mode (default)

Hold (>=1s) Talk (unmute microphone) Release Stop talking (mute microphone) Short press (<1s) Switch to always-on mode Double press Hang up

In call — Always-on mode (toggled)

Short press (<1s) Switch to push-to-talk mode Double press Hang up

RGB LED indicates state:

Blue   = ready, showing channels
Orange = calling
Green  = in call
Yellow = transmitting (PTT mode, mic active)

Initial Setup Order

Ensure ~/.lxst-client or /etc/lxst-client exists
Place bridge_whitelist.json in either directory (or pass with -w)
First run creates identity automatically at configdir/identity
In CLI mode: run python client.py then d to discover channels
In GUI mode: run python client.py -W — auto-discovers on startup
Messages appear in configdir/lxmf/

Known quirks

If bridge_whitelist.json is missing, client prints an error and returns.
Identity is auto-generated on first run if not present.
Use -v for RNS debug output (path discovery is verbose here).
Path discovery waits up to 10s for relays; increase timeout in client code if needed.
Whisplay mode requires Pillow and the Whisplay runtime (whisplay.py / whisplay_client.py).
Falls back to CLI gracefully if Whisplay hardware or dependencies are unavailable.

2.4 KiB Raw Blame History