Files
uv-k1-k5v3-firmware-custom/desktop
2025-07-20 02:28:43 +02:00
..
2025-07-20 02:28:43 +02:00
2025-07-17 05:28:35 +02:00

Quansheng K5 Viewer

This Python script is a simple viewer that displays current screen from the Quansheng K5 transceiver (under F4HWN firmware), transmitted via a serial connection (UART).

🚀 Features

  • Realtime display of 128×64 monochrome screen via serial connection (UART)
  • Delta frame update support for reduced bandwidth
  • Screenshot capture in PNG format
  • Background color toggle: gray, blue or orange
  • Invert video mode
  • Increase or decrease window size
  • Display FPS in window title

🛠️ Requirements

  • Python 3.6+
  • pip (Python package installer)

📦 Install dependencies:

If necessary, use this command to install dependencies:

pip install pyserial pygame

▶️ How to Run

  1. Connect your Quansheng K5 (running F4HWN firmware) to your computer via your Baofeng/Kenwood-like USB-2-Serial-cable.
  2. Edit the SERIAL_PORT value in viewer.py to match your system:
SERIAL_PORT = '/dev/cu.usbserial-xxxx'  # macOS/Linux
# or
SERIAL_PORT = 'COM3'                    # Windows
  1. Then start the viewer:
python k5viewer.py

🎮 Controls

Key Action
Q Quit the viewer
G Set background to gray
B Set background to blue
O Set background to orange
I Toggle video inversion
SPACE Save a screenshot as PNG
UP Increase window size
DOWN Decrease window size

Screenshots are saved as screenshot_YYYYMMDD_HHMMSS.png in the same directory.

📬 Contact

If you encounter issues or have suggestions, feel free to open an issue or submit a pull request. Enjoy building with your Quansheng K5! 📡