From 80d043db9078b9a5266deb1d3ee5a64517c63b6f Mon Sep 17 00:00:00 2001
From: bocil kematian <rizqiv2@gmail.com>
Date: Fri, 29 May 2026 13:57:04 +0700
Subject: [PATCH] Add files via upload

---
 README.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..94ed639
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+# OpenVPN GUI
+
+A small Linux GUI for importing OpenVPN profiles and connecting or disconnecting them.
+
+## Requirements
+
+- Python 3 with Tkinter
+- `openvpn`
+- `pkexec` from Polkit, or `sudo`, so OpenVPN can create the VPN tunnel
+
+Ubuntu/Debian example:
+
+```bash
+sudo apt install python3-tk openvpn policykit-1
+```
+
+## Run
+
+```bash
+python3 openvpngui.py
+```
+
+## Use
+
+1. Click **Import** and choose a `.ovpn` or `.conf` file.
+2. Give the profile a friendly name.
+3. Select the profile and click **Connect**.
+4. Click **Disconnect** to stop the active tunnel.
+
+Imported profiles are saved in:
+
+```text
+~/.config/openvpngui/profiles
+```
+
+The app also copies common relative companion files referenced by the profile, such as `ca`, `cert`, `key`, `tls-auth`, `tls-crypt`, `pkcs12`, and `auth-user-pass`. Profiles that reference absolute file paths still need those paths to remain available.
+
+## Notes
+
+- Some OpenVPN profiles prompt for username/password in a terminal. For a GUI flow, use a profile with an `auth-user-pass` file or embedded provider-specific authentication.
+- Closing the window while connected asks whether to disconnect first.