# LXST Client

Single-file Python CLI for managing LXST Channel connections via Reticulum Network (RNS) and LXMF protocols.

## Running

  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

## Commands

  python client.py -c /etc/lxst-client -w /etc/lxst-client/bridge_whitelist.json

  Inside the interactive client:
    d  Discover channels from whitelist
    l  List discovered channels
    <NUM>  Connect to channel at index NUM (1-based)
    q  Quit

## Initial Setup Order

  1. Ensure ~/.lxst-client or /etc/lxst-client exists
  2. Place bridge_whitelist.json in either directory (or pass with -w)
  3. First run creates identity automatically at configdir/identity
  4. Run `python client.py` then `d` to discover channels
  5. 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.