How protonvpn/proton-vpn-gtk-app works
Project type and purpose
• This is a desktop GUI application (GTK) written in Python.
• Its purpose is to provide an end-user interface for Proton VPN service: authenticate users, list servers, establish/monitor VPN connections, handle reconnection logic, and surface status & notifications.
File structure
• Top-level directories:
• debian, rpmbuild → packaging metadata and scripts for .deb/.rpm builds
• proton/vpn/app/gtk → main application code
• scripts → versioning and changelog automation
• tests → integration (Behave) and unit tests
• Inside proton/vpn/app/gtk:
• app.py, __main__.py → entry point
• controller.py + config.py → application orchestration & configuration
• widgets/… → UI components grouped by screen/feature (login, main, vpn, headerbar menus)
• services/reconnector/… → background monitors (session, network, VPN) and reconnection logic
• utils/… → helper modules (executor, exception_handler, glib wrappers, semver, etc.)
• Packaging & CI files (setup.py, setup.cfg, .gitlab-ci.yml) configure build, test, and release pipelines.
README for additional insights
• Confirms GTK-based front end for Proton VPN users
• Describes virtual environment and custom PyPI registry
• Explains where logs (~/.cache/Proton/VPN/logs) and user settings (~/.config/Proton/VPN) live
• Outlines how to run unit tests (pytest/unittest) and integration tests (Behave, Xvfb)
• Versioning automated via versions.yml + custom scripts