https://github.com/r0mb0/pivpn_gui
I just wanna try to create a GUI for PIVPN in way to make easy interact with the service and increase some features
https://github.com/r0mb0/pivpn_gui
desktop-app desktop-application flutter flutter-app itai-developers linux pivpn r0mb0 university-project urbino-university vpn vpn-manager
Last synced: 28 days ago
JSON representation
I just wanna try to create a GUI for PIVPN in way to make easy interact with the service and increase some features
- Host: GitHub
- URL: https://github.com/r0mb0/pivpn_gui
- Owner: R0mb0
- License: agpl-3.0
- Created: 2024-12-17T13:52:51.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-29T12:57:59.000Z (about 1 month ago)
- Last Synced: 2026-04-29T14:47:43.835Z (about 1 month ago)
- Topics: desktop-app, desktop-application, flutter, flutter-app, itai-developers, linux, pivpn, r0mb0, university-project, urbino-university, vpn, vpn-manager
- Language: Dart
- Homepage:
- Size: 832 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
README
Urbino`s University - Computing and digital innovation - Programming of mobile devices and user interfaces
- For the professor: [Submit](https://github.com/R0mb0/PIVPN_GUI/tree/main/Submit)
# PIVPN GUI
[](https://app.codacy.com/gh/R0mb0/PIVPN_GUI/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
[](https://github.com/R0mb0/PIVPN_GUI)
[](https://github.com/R0mb0/PIVPN_GUI)
[](https://www.gnu.org/licenses/gpl-3.0)
[](http://paypal.me/R0mb0)
## Description
**PIVPN GUI** is a flutter application to simplify the manage of [`PIVPN`](https://github.com/pivpn/pivpn) service for most of commons users. It provide the "time to be enabled" functionality, in way to automatic disable clients that had terminated their "enabled time". For example this functionality is usefull if the vpn is used to distribute a subscription service.
> Until the application is open, one time a day, the application will check all user statuses, disabling the users with their "time to be enabled" over.
## How to install
### 1. PIVPN installation
- [how to install PIVPN](https://github.com/pivpn/pivpn)
### 2. Flutter installation
- [How to install flutter](https://flutter-ko.dev/get-started/install)
### 3. Download the application
- ```bash
git clone https://github.com/R0mb0/PIVPN_GUI.git
```
## How to run
1. Enter into the working directory
```bash
cd PIVPN_GUI/PIVPN_GUI/pivpn_gui/lib
```
2. Make executable `make_all_scripts_executable.sh` script
```bash
chmod +x make_all_scripts_executable.sh
```
3. Run the script
```
./make_all_scripts_executable.sh
```
4. Create the `password.sh` file
- Create with your favorite editor `password.sh`
```bash
nano password.sh
```
- Add this code inside the file
```bash
#!/bin/bash
PASSWORD = "your_sudo_password"
```
Save the file
`ctrl + o`
`ctrl + x`
5. Run the application
```bash
flutter run
```
## Interface description
- `Name`, `Start Date`, `End Date` are "Text Fields"
- `ADD USER`, `REMOVE USER`, `ENABLE USER`, `DISABLE USER` are "Buttons"
- In the center, below the "Buttons" there's the section for the application's allerts
- In the center of the page there's a table where check all clients and client statuses
## How to use
> `Name` field is used for all operations
> `Start Date`, `End Date`Fields are used only for "add new user" operation
> To create a "always allowed" user, insert a far away date as "End Date"
### Add a new user
- Complete `Name`, `Start Date` and `End Date` fields
- Press `ADD USER` button
### Remove an user
- write the name of the user to remove in `name` field
- Press `REMOVE USER` button
### Enable an user
- write the name of the user to enable in `name` field
- Press `ENABLE USER` button
- **Is not possible enable a user the have his "End date" expired.**
To do this, remove the user and adding it with updated dates.
### Disable an user
- write the name of the user to disable in `name` field
- Press `DISABLE USER` button
