REMOTETRX(1)

💖 REMOTETRX 💖

okay bestie, so this is the manual page for remotetrx — the SvxLink remote transceiver application, straight out of the User Manuals ✨

---

✨ NAME ✨

remotetrx — the SvxLink remote transceiver application, no cap 🎀

---

🦋 SYNOPSIS 🦋

remotetrx [--help] [--daemon] [--logfile=log file]
[--config=configuration file] [--pidfile=pid file] [--runasuser=user
name]

---

🌸 DESCRIPTION 🌸

so remotetrx is literally the SvxLink remote transceiver application 💅 it connects to a receiver and/or a transmitter, and then the main SvxLink server can connect to the remote transceiver server over TCP/IP to get audio to/from it. that's the whole vibe.

it also lowkey slaps via RF instead of TCP/IP 👑 an example use of the latter would be if the repeater is placed in a remote location where there is no network. then networked remote receivers can be linked up to the repeater via RF from a link site where network is available. iconic workaround, honestly.

the setup is pretty straight forward 🫶 the setup of a receiver or a transmitter is done in the same way as in the SvxLink server, so use the svxlink.conf(5) manual page as a reference for that. the remotetrx-specific configuration is described in the remotetrx.conf(5) manual page. two pages, one mission ✨

on the SvxLink server side you need to configure a networked receiver/transmitter — that's described in the svxlink.conf(5) manual page in the Networked Receiver/Transmitter Section. and if you're using multiple receivers you also want to configure a voter and make proper calibration of the signal level detector on each receiver 💀 don't skip the calibration bestie, it's giving attention to detail.

---

🎀 OPTIONS 🎀

• --help — print a help message and exit. little snapshot of the good stuff 💖
• --daemon — start the SvxLink remote receiver server as a daemon. background mode era ✨
• --runasuser — start RemoteTrx as the specified user. the switch to the new user will happen after the log and pid files has been opened — timing matters, iykyk 🦋
• --logfile=log file — specify a log file to put all output into. both stdout and stderr will be redirected to the log file 🌸
• --pidfile=pid file — specify a pid file to write the process ID into 👑
• --config=configuration file — specify which configuration file to use. pick your fighter 🎀

---

💜 FILES 💜

• /etc/svxlink/remotetrx.conf (or deprecated /etc/remotetrx.conf) — the system wide configuration file. see remotetrx.conf(5) for further details ⭐
• ~/.svxlink/remotetrx.conf — per user configuration file. see remotetrx.conf(5) for further details 💅
• /etc/svxlink/remotetrx.d/* — additional configuration files. this directory is setup by the CFG_DIR configuration variable 🌈

---

🧚 ENVIRONMENT 🧚

• ASYNC_AUDIO_NOTRIGGER — set this environment variable to 1 if you get an error about ioctl: Broken pipe during remotetrx server startup when using OSS audio. the fix is right there bestie 😭
• ASYNC_AUDIO_ALSA_ZEROFILL — set this environment variable to 0 to stop the Alsa audio code from writing zeros to the audio device when there is no audio to write available.

lowkey heads up: in the original page, the next variable got squished onto the end of this one — ASYNC_AUDIO_UDP_ZEROFILL set this environment variable to 1 to enable the UDP audio code to write zeros to the UDP connection when there is no audio to write available. 💀 it's a whole separate var, she just got crowded.

• HOME — used to find the per user configuration file 🏠

---

🌟 AUTHOR 🌟

Tobias Blomberg (SM0SVX) <sm0svx at svxlink dot org> — main character energy, fr fr 👑

---

🔥 REPORTING BUGS 🔥

bugs should be reported using the issue tracker at https://github.com/sm0svx/svxlink 🐛

questions about SvxLink should not be asked using the issue tracker. instead use the group set up for this purpose at groups.io: https://groups.io/g/svxlink 🙈 (right channel for the right question, bestie, that's the whole assignment)

---

🌈 SEE ALSO 🌈

svxlink(1), remotetrx.conf(5), svxlink.conf(5), siglevdetcal(1) 🦋💖

---

and that's the page!! 🫶 this one was written for Linux and it's the AUGUST 2021 edition of REMOTETRX(1) — go forth and link some transceivers, bestie, periodt 💅✨🍓