Hush

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

★ 21 Open GitHub ↗

A new HF digital ARQ/QSO mode.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Hush
A new HF digital ARQ/QSO mode.

## Running

Start the control server (TCP JSON, newline-delimited) on `127.0.0.1:53421`:

```bash
cargo run --release
```

If you're in an environment without audio devices, use dummy loopback mode:

```bash
cargo run --release -- --no-audio
```

## Loopback test (2 modems)

Runs two in-process modems that connect and exchange messages, and writes an audible stereo WAV:

```bash
cargo run --release -- --loopback-test --seconds 8 --speed MEDIUM --wav loopback_test.wav
```

## Live loopback (2 TNCs)

Runs two in-process TNCs bridged together. Control each side by setting `tnc` to `0` or `1` (the terminal does this with the `tnc` command):

```bash
cargo run --release -- --loopback-live --bind 127.0.0.1:53421 --out <output_id>
python hush_term.py --advanced 127.0.0.1 53421
```

## Control protocol (quick)

- `{"cmd":"list_devices"}`
- `{"cmd":"open","input":<id>,"output":<id>,"sr":48000}`
- `{"cmd":"list_modes"}` / `{"cmd":"set_mode","mode":"mfsk|fsk2|fsk4|ofdm"}`
- `{"cmd":"list_profiles"}` / `{"cmd":"set_profile","profile":"QRP2|MFSK3|OFDM5|..."}`
- `{"cmd":"send_frame","mode":"mfsk","speed":"MEDIUM","payload_bits":"0101..."}` (raw MFSK bits for quick testing)
- `{"cmd":"connect","my":"K1ABC","to":"K2XYZ"}` / `{"cmd":"disconnect"}`
- `{"cmd":"send_data","text":"HELLO OVER HUSH"}` (framed + CRC + FEC + stop-and-wait ARQ; requires `connect`)
- `{"cmd":"rx_pop","max":20}` (fetch delivered payloads)
- `{"cmd":"status"}` / `{"cmd":"close"}`

## Terminal client

`hush_term.py` is a simple interactive terminal for the control port:

```bash
python hush_term.py 127.0.0.1 53421
```

Advanced terminal features:

```bash
python hush_term.py --advanced 127.0.0.1 53421
```

Hush

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README