Gabby Pelton
39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
# 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.
|