Cloudflare WARP GUI Client (Python/PyQt6)

A lightweight graphical user interface for the warp-cli console client. Designed for Linux systems with system tray support (KDE, GNOME, XFCE).

System Requirements

1. Cloudflare WARP:
   • The warp-cli package must be installed.
   • The service must be running: sudo systemctl enable --now warp-svc.
2. Python 3.10+ and the PyQt6 library.

Installing Dependencies

Install PyQt6 using your package manager:

Arch Linux / CachyOS

sudo pacman -S python-pyqt6 

Ubuntu / Debian

sudo apt update && sudo apt install python3-pyqt6 

Fedora

sudo dnf install python3-pyqt6 

Running the Application

The application is launched with a single command from the project folder:

python3 "Cloudflare Warp cli GUI.py" 

Instructions

1. Registration: If using WARP for the first time, run warp-cli registration new.
2. Management:
   • Connect/Disconnect: Buttons for quick connection control.
   • Tray: When the window is closed, the application minimizes to the system tray. Click the tray icon to restore the window or exit.
3. Status: Real-time detailed information is displayed from the warp-cli status output.

Troubleshooting

• If the command is not found, ensure that warp-cli is installed.
• If there is no connection to the service, check the status: systemctl status warp-svc.