Quick start

Three common paths, fastest first. All of them work with no radio hardware if you substitute the bundled emulator for the radio.

1. Desktop GUI on the same LAN as the radio

Extract the GUI bundle for your platform (downloads).
Launch it:
- Linux: ./run.sh
- macOS: double-click PodSDR.app (first launch: right-click → Open, or xattr -dr com.apple.quarantine PodSDR.app — the app is ad-hoc signed, not notarized).
- Windows: double-click podsdr-gui.exe.
The GUI auto-discovers OpenHPSDR radios on the LAN. Pick your radio and connect.

No hardware? Start the emulator from a server bundle first — on the same machine or anywhere on the LAN:

./podsdr-emu --radio hermeslite

It shows up in the radio picker like a real Hermes Lite.

Copy the Pi server bundle over and unpack it:

scp podsdr-proxy-pi-bundle.tar.gz pi@pi.local:~/
ssh pi@pi.local 'tar xzf podsdr-proxy-pi-bundle.tar.gz && ./podsdr-proxy-pi-bundle/run.sh'

On any computer/tablet on the LAN, open https://pi.local:8080.
Accept the self-signed-certificate warning (once per browser profile — see why HTTPS).
Pick a radio from the device list and connect.

To survive reboots, install the bundled systemd service — Running as a system service.

On the machine next to the radio, start the cloud uplink instead of (or in addition to) the LAN server:
```
./run-cloud.sh home        # "home" is the name this proxy will show as
```

Watch the console for the highlighted line:

>>> PAIRING CODE for "home":  XXXX   -- enter it in a client Cloud hub panel <<<

In any client (web, desktop GUI, Android), open the Cloud hub panel and enter the pairing code. That claims the proxy under your account — from then on your authorized clients can connect to it from any network, with no port forwarding.