Autostart TCI on launch¶
Configure AetherSDR to start the TCI WebSocket server automatically every time the application launches, so third-party software such as Log4OM or SunSDR tools connects without manual intervention.
Before you start¶
- AetherSDR must be built with WebSocket support (
HAVE_WEBSOCKETS). If the TCI tray button is absent, this build does not include TCI. - The radio must be connected before the TCI server can serve clients, though the autostart setting can be configured while disconnected.
- Decide which port the server should use. The default is
50001. See Change the TCI port if you need a different port before enabling autostart.
Steps¶
- Click
Settings > Autostart TCI with AetherSDR. - Confirm the item is checked. AetherSDR will now start the TCI server on every subsequent launch.
- To verify the setting took effect immediately, click the TCI tray button on the right sidebar to open the TCI Server applet. The server status should read
:<port> (0 clients)rather than(stopped).
To disable autostart, click Settings > Autostart TCI with AetherSDR again to uncheck it.
What each control does¶
| Control | Default | Valid range |
|---|---|---|
Settings > Autostart TCI with AetherSDR (checkable menu item) |
Off | On / Off |
| Port | 50001 |
1024–65535 |
| Enable (toggle button in TCI Server applet) | Off | On / Off |
| RX1–RX4 gain+meter | 0.5 | 0.0–1.0 |
| TX gain+meter | Drags set the TCI TX gain and emit tciTxGainChanged. | TciServer::setTxGain persists TciTxGain internally; UI mirrors the stored value. TCI TX audio is always allowed regardless of platform or hosted-DAX availability (evaluateDaxTxPolicy now unconditionally allows DaxTxRequestReason::TciTxAudio, v0.9.5.1, #2276). |
| ## Tips |
- Enabling autostart also sets
AutoStartTCItoTrue. Toggling Enable in the TCI Server applet writes the same key, so both controls stay in sync. - If the port is already in use at launch, the server will not start: the Enable toggle snaps back to off and the status shows
(port in use). Change the port and restart AetherSDR, or clear the conflicting process. - Out-of-range port values snap back to
50001automatically.
Troubleshooting¶
Settings > Autostart TCI with AetherSDRis absent from the menu — This build of AetherSDR does not include WebSocket support. TCI is unavailable.- Server status shows
(port in use)after launch — Another process is already bound to the configured port. Change the port in the TCI Server applet's Port field, save, and restart AetherSDR. See Change the TCI port. - Status stays
(stopped)despite autostart being enabled — The radio is not yet connected. The TCI server requires a radio connection. Connect to the radio; the server will start once the connection is established.