Skip to content

andknownmaly/OpenVPN-GUI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🧩 OpenVPN GUI for Linux

License: MIT Platform Python GTK

A modern, lightweight, and user-friendly OpenVPN client GUI for Linux, built with GTK and Python. Easily manage and connect to multiple VPN profiles with secure password handling and tray integration.


OpenVPN GUI Screenshot

🚀 Features

  • 🧭 Simple and intuitive GTK interface
  • 🔐 Secure password handling
  • 🗂️ Manage multiple OpenVPN profiles easily
  • 🪟 System tray integration for quick access
  • 💾 SQLite-backed configuration database
  • ⚙️ Works seamlessly on Debian-based distros (Ubuntu, Kali, etc.)

🧰 Requirements

Make sure these dependencies are installed:

sudo apt install python3 python3-gi openvpn

🧩 Installation

  1. Clone this repository:

    git clone https://github.com/andknownmaly/OpenVPN-GUI.git
    cd OpenVPN-GUI
  2. Run the installer:

    chmod +x install.sh
    ./install.sh

🧠 Tip: The installer automatically configures the TUN module so you don’t need to run sudo modprobe tun manually anymore.


💡 Usage

  1. Launch OpenVPN GUI from the applications menu or run:

    opengui
  2. Click “Add Connection” to import your .ovpn file

  3. Assign a custom name and connect using the toggle switch

  4. Right-click a connection to edit or delete it


⚙️ Configuration Details

  • All VPN configurations are stored in:

    ~/.config/openvpn-gui/configs.db
    
  • The GUI runs OpenVPN using sudo for secure network control

  • Renaming connections doesn’t affect the original .ovpn files


❌ Uninstallation

To completely remove OpenVPN GUI:

chmod +x uninstall.sh
./uninstall.sh

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to open a Pull Request.


🪪 License

This project is licensed under the MIT License — see the LICENSE file for details.