svx

Interactive terminal tool for administering SvxLink services on a Raspberry Pi.

Features

• Start / Stop / Restart / Reload services
• Detailed service status and live log following (journald or file)
• Edit configuration, GPIO, and environment files
• Enable / Disable services at boot
• GPIO setup restart
• Alsamixer integration (auto-detects USB audio device)
• Log rotation check and auto-fix
• Live system info: service status, CPU temperature, uptime, last boot

Services managed

• svxlink.service — Main repeater controller
• remotetrx.service — Remote transceiver
• svxreflector.service — Reflector/conference server
• svxlink_gpio_setup.service — GPIO pin setup

Requirements

• Raspberry Pi (or Debian-based system) with SvxLink installed
• dialog or whiptail (auto-detected, will offer to install if missing)

Install

sudo curl -sL https://raw.githubusercontent.com/audric/svxlink-cmd/master/svx -o /usr/local/bin/svx && sudo chmod +x /usr/local/bin/svx

Usage

sudo svx

Screenshot

○ SvxLink  ○ RemoteTRX  ○ SvxReflector | 48°C  Up 3d 2h  Since 2026-03-28 14:30
┌──────────── Svx Admin v1.0.0 ────────────┐
│                                           │
│  Choose an action:                        │
│ ┌───────────────────────────────────────┐ │
│ │  1  Start service                     │ │
│ │  2  Stop service                      │ │
│ │  3  Restart service                   │ │
│ │  4  Reload config (SIGHUP)            │ │
│ │  ─  ─── Monitoring ─────────          │ │
│ │  5  Show detailed status              │ │
│ │  6  Follow live logs                  │ │
│ │  ─  ─── Configuration ──────          │ │
│ │  7  Edit config file                  │ │
│ │  8  Edit GPIO config                  │ │
│ │  9  Edit environment defaults         │ │
│ │  ─  ─── Audio ──────────────          │ │
│ │ 10  Alsamixer                         │ │
│ │  ─  ─── Maintenance ────────          │ │
│ │ 11  Check log rotation                │ │
│ │  ─  ─── Boot & GPIO ────────          │ │
│ │ 12  Enable service at boot            │ │
│ │ 13  Disable service at boot           │ │
│ │ 14  Restart GPIO setup                │ │
│ └───────────────────────────────────────┘ │
│          <OK>          <Quit>             │
└───────────────────────────────────────────┘

Author

Audric IW1GEU

Other projects

Check out SvxReflectorDashboard — a web dashboard for SvxReflector.

License

GPL-3.0