Repository navigation
Section 8 2 connect a native remote client
From the GUI, on any other machine running sdroxide: open Settings → General, enter the server's Address and Port in the connect section at the bottom, and press CONNECT.
The station comes up as a radio tab of its own, beside whatever radios that sdroxide already has open — the tab strip at the top of the window switches between them, and ⊞ puts two side by side (2.17). Your own radio keeps running while you work the remote one. To hang up, close the tab from the roster at the top of Settings → Radio; nothing on the server is changed by that. Adding a radio on the server, and closing one there, are separate and clearly-marked actions in the same roster — see 2.17. If the server asks for a username and password, its sign-in screen appears in the new tab (8.3).
The address is remembered in config.toml on the machine you typed it on, so
the next connection is one button. Address takes a host name, an IPv4 or
IPv6 address, or a complete ws://… (or wss://) URL if the server sits behind
a reverse proxy — a URL is used exactly as typed and ignores the port box.
Port is server_port from the server's own config.toml, 4950 unless it
was given --port.
The same thing from the command line, which starts sdroxide as a client and nothing else:
sdroxide --connect HOST:4950
--connect accepts host, host:port, or a full ws://… URL. A client
started this way has no radio of its own — and can still reach Settings →
General to connect to a second station.
A station with several radios arrives with all of them. The connection you make is to one radio — the first, unless you named another — and the station says what else it has; the client opens the rest beside it, one tab each. So dialling a server that has an RTL-SDR and a Pluto gives you the same two tabs you would have standing in front of them, ⊞ included (2.17). The tab you dialled keeps the name you typed; the others are named as the station names them.
Each of those tabs is a connection of its own. You still sign in once: a station that asks for a password asks each connection separately, and the tabs behind the one you answered let themselves in with what you gave it, for as long as the program runs (8.3). Each tab does carry its own audio and spectrum, though, so on a thin link close the radios you are not using: a tab you close stays closed until you dial the station again.
To open just one radio of a station, name it in the address:
sdroxide --connect HOST:4950/ws/1, or type the full ws://HOST:4950/ws/1 in
the Address box. /radios on the server says which id is which
(8.1).
Either way, a remote client is the full sdroxide GUI running against the server: control, state, memories, meters, spectrum, FT8 decodes and logging, and skimmer spots all work. Receive audio streams down (48 kHz mono), and your microphone is sent up to the server while you transmit. The remote client uses your local speakers and microphone for audio.
From the User Manual. Home.