A modern, native GTK4 companion for the Quansheng UV-K5 (and K6/5R) radio series.

Antenna is a powerful desktop utility designed for configuring, programming, and interacting with Quansheng UV-K5, K5(8), K6, and 5R handheld radios. Built with GTK4 and LibAdwaita, it offers a clean, modern experience that fits perfectly on the GNOME desktop.

Unlike web-based tools, Antenna is a native application with direct hardware access, offering robust serial communication, offline functionality, and advanced scripting capabilities.

• Memory Management: Read, edit, and write channels with an easy-to-use tabular interface. Supports import/export of CSV and Chirp-formatted files.
• Firmware Flashing: Safely flash custom firmware (MODS) directly from the app. Includes an integrated firmware library to browse and download popular mods (Egzumer, F4HWN, etc.) from GitHub.
• Calibration: View and backup critical radio calibration data (EEPROM backup).
• Live Screen Mirroring: Mirror the radio's LCD to your computer screen in real-time (supported on compatible custom firmwares).
• Virtual Remote: Control your radio remotely using a virtual keypad and knobs.

• Scripting Engine: unique JavaScript-based scripting engine ("Antigravity") lets you automate tasks, send raw protocol commands, and create custom workflows.
• Serial Terminal: Built-in serial console for debugging and direct communication.
• Profile System: Extensible profile system supports different firmware versions (Stock, Egzumer, F4HWN) with unique memory maps and settings. capable of auto-detecting the running firmware.

• Device Handling: robust handling of generic USB-Serial adapters (CH340/CP210x) with automatic DTR/RTS management to prevent connection issues.
• Beautiful UI: First-class LibAdwaita application with dark mode support, adaptive layout, and polished aesthetics.

Antenna is available on Flathub (Coming Soon). For now, you can build from source.

Dependencies:

• gjs (>= 1.70)
• gtk4
• libadwaita
• mesen
• ninja

Build Steps:

# Clone the repository
git clone https://github.com/qshosfw/Antenna.git
cd Antenna

# Build with Meson
meson setup builddir --prefix=/app
meson compile -C builddir

# Run directly
meson install -C builddir
com.qshosfw.antenna

1. Connect your Quansheng radio using a K-Plug programming cable.
2. Ensure the cable is firmly pressed in.
3. Open Antenna.
4. Click Connect. The app will auto-detect the port (usually /dev/ttyUSB0 or /dev/ttyACM0).
   • Note: If using a standard CH340 cable, Antenna automatically handles the tricky DTR/RTS signals that often cause issues on Linux.

Antenna supports multiple firmware variations:

• Stock UV-K5: Standard factory layout.
• F4HWN: Advanced generic support (v4.3+).
• Egzumer: (Coming soon)
• Custom: Import your own .js profile in Preferences > Profiles.

Contributions are welcome! Whether it's adding a new firmware profile, fixing bugs, or improving the UI.

1. Fork the repository.
2. Create a feature branch.
3. Submit a Pull Request.

This project is licensed under the GPL-3.0 License.

Made with ❤️ for the Ham Radio community.