Metadata-Version: 2.1
Name: protonvpn-cli-gui
Version: 0.1.9
Summary: An unofficial GUI for ProtonVPN on Linux.
Home-page: https://github.com/jcemerson/protonvpn-cli-gui
Author: WutDuk
Author-email: wutduk@pm.me
License: GPLv3
Description: 
        <h1 align="center">ProtonVPN-CLI-GUI</h1>
        
        <p align="center">
          <img src="https://github.com/jcemerson/protonvpn-cli-gui/blob/package/protonvpn_cli_gui/images/protonvpn-wallpaper-7.jpg" alt="ProtonVPN"></img>
        </p>
        
        <p align="center">
          <img src="https://img.shields.io/github/v/release/jcemerson/protonvpn-cli-gui?include_prereleases&style=flat-square" alt="GitHub Downloads"></img>
        </p>
        <p align="center">
            <a href="https://pepy.tech/project/protonvpn-cli-gui">
              <img alt="Downloads per Week" src="https://pepy.tech/badge/protonvpn-cli-gui">
            </a>
          <img src="https://img.shields.io/pypi/dm/protonvpn-cli-gui?style=flat-square" alt="PyPi Downloads"></img>
        </p>
        
        <p align="center">
          <img src="https://img.shields.io/pypi/pyversions/protonvpn-cli-gui?style=flat-square" alt="Python Versions"></img>
          <img src="https://img.shields.io/pypi/wheel/protonvpn-cli-gui?style=flat-square" alt="Wheel"></img>
          <img src="https://img.shields.io/pypi/l/protonvpn-cli-gui?style=flat-square" alt="License"></img>
        </p>
        
        <h3 align="center">A GUI for <a href="https://github.com/ProtonVPN/protonvpn-cli-ng"><b>ProtonVPN-CLI</b></a> on Linux (Unofficial), written entirely in Python.</h3>
        
        ProtonVPN-CLI-GUI is <a href="https://github.com/kivy/kivy"><b>Kivy</b></a>-based GUI built on top of <a href="https://github.com/ProtonVPN/protonvpn-cli-ng"><b>protonvpn-cli-ng</b></a> as the back-end. Wherever possible, the GUI relies on the actual code of the CLI, so ProtonVPN-CLI-GUI will remain up to date with <a href="https://github.com/ProtonVPN/protonvpn-cli-ng"><b>ProtonVPN-CLI</b></a>.
        
        
        
        ### Installing Dependencies
        
        **Dependencies:**
        
        - <a href="https://github.com/kivy/kivy"><b>Kivy</b></a>
        - <a href="https://github.com/OpenVPN/openvpn"><b>OpenVPN</b></a>
        - <a href="https://github.com/pypa/pip"><b>pip for Python3 (pip3)</b></a>
        - <a href="https://github.com/ProtonVPN/protonvpn-cli-ng"><b>ProtonVPN-CLI</b></a>
        - <a href="https://www.python.org/"><b>Python3.6+</b></a>
        - <a href="https://pypi.org/project/setuptools/"><b>setuptools for python3 (python3-setuptools)</b></a>
        
        To install <a href="https://github.com/ProtonVPN/protonvpn-cli-ng"><b>ProtonVPN-CLI</b></a>, depending on your distribution, run the appropriate following command to install the necessary dependencies.
        For more detailed information on installing, updating and uninstalling, please view the extensive [usage guide](https://github.com/ProtonVPN/protonvpn-cli-ng/blob/master/USAGE.md#installation--updating):
        
        | **Distro**                              | **Command**                                                        |
        |:----------------------------------------|:------------------------------------------------                   |
        |Fedora/CentOS/RHEL                       | `sudo dnf install -y openvpn dialog python3-pip python3-setuptools`|
        |Ubuntu/Linux Mint/Debian and derivatives | `sudo apt install -y openvpn dialog python3-pip python3-setuptools`|
        |OpenSUSE/SLES                            | `sudo zypper in -y openvpn dialog python3-pip python3-setuptools`  |
        |Arch Linux/Manjaro                       | `sudo pacman -S openvpn dialog python-pip python-setuptools`       |
        
        
        Once you've installed <a href="https://github.com/ProtonVPN/protonvpn-cli-ng"><b>protonvpn-cli-ng</b></a>, install <b>ProtonVPN-CLI-GUI</b>.
        
        *Note: This has only been tested on Linux Mint 19.3 Cinnamon.*
        
        
        ## Installing ProtonVPN-CLI-GUI
        
        You can either install via <b>PIP</b> (simple) or by cloning this repository (must manually manage dependencies, etc).
        
        *Note: Make sure to run pip with sudo*
        
        `sudo pip3 install protonvpn-cli-gui`
        
        
        
        ### To update to a new version
        
        `sudo pip3 install protonvpn-cli-gui --upgrade`
        
        
        
        ## Manual Installation
        
        1. Clone this repository:
        
            `git clone https://github.com/jcemerson/protonvpn-cli-gui`
        
        2. Navigate to the directory:
        
           `cd {/path/to/directory/}protonvpn-cli-gui`
        
        3. Install:
        
            `sudo python3 setup.py install`
        
        
        
        ### How to use
        
         `sudo protonvpn-cli-gui`
        
        
        ### Recommendation for Convenience:
        For passwordless execution without using a terminal, such as by automated script or .desktop file, <a href="https://www.linux.com/training-tutorials/configuring-linux-sudoers-file/"><b>update your sudoers file</b></a> by using `sudo visudo` and paste the following at the bottom (last line) of your file:
        
        `{your_linux_username} ALL = (root) NOPASSWD: /usr/local/bin/protonvpn-cli-gui`
        
        *Note: The path to your bin might be different. To find, use* `which protonvpn-cli-gui`
        
        
        
        ## Create .desktop file
        
        To create a desktop application launcher using a .desktop file:
        
        1. Create a new file in `.local/share/applications/` named `protonvpn-cli-gui.desktop` with the following contents:
        
            ```
            [Desktop Entry]
            Name=ProtonVPN-CLI-GUI
            GenericName=ProtonVPN-CLI-GUI
            Exec=sudo protonvpn-cli-gui
            Icon={path/to/icon}
            Type=Application
            Terminal=False
            Categories=Network;VPN
            ```
            *Note: Be sure to update the Icon with your own path to an image file.*
        
        
        
        ### This is a pre-release and not all planned features have been implemented.
        
        Some remaining features include:
        
        - Logging (GUI-only. Kivy, OpenVPN, and ProtonVPN-CLI all have logs of their own.)
        - Searchable Server List
        - Start on Boot
        - Connection Profiles (user-configurable connection profiles that can be saved, e.g. "Fastest TOR server with TCP connection", "Fastest P2P server in Iceland", etc.).
        - Built-in Connection Speed Test
        - System Tray icon with connection status notification
        
        
        
        ## Screenshots
        
        <p align="center">
          <img src="https://github.com/jcemerson/protonvpn-cli-gui/blob/master/protonvpn_cli_gui/images/Screenshot%20from%202020-03-22%2020-25-10.png" alt="Main Screen"></img>
        </p>
        
        <p align="center">
          <img src="https://github.com/jcemerson/protonvpn-cli-gui/blob/master/protonvpn_cli_gui/images/Screenshot%20from%202020-03-22%2020-27-33.png" alt="Secure Core Notification"></img>
        </p>
        
        <p align="center">
          <img src="https://github.com/jcemerson/protonvpn-cli-gui/blob/master/protonvpn_cli_gui/images/Screenshot%20from%202020-03-22%2020-27-52.png" alt="Disconnected"></img>
        </p>
        
        <p align="center">
          <img src="https://github.com/jcemerson/protonvpn-cli-gui/blob/master/protonvpn_cli_gui/images/Screenshot%20from%202020-03-22%2020-28-47.png" alt="Secure Core"></img>
        </p>
        
        <p align="center">
          <img src="https://github.com/jcemerson/protonvpn-cli-gui/blob/master/protonvpn_cli_gui/images/Screenshot%20from%202020-03-22%2020-29-27.png" alt="Menu"></img>
        </p>
        
        <p align="center">
          <img src="https://github.com/jcemerson/protonvpn-cli-gui/blob/master/protonvpn_cli_gui/images/Screenshot%20from%202020-03-22%2020-30-00.png" alt="VPN Settings"></img>
        </p>
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: POSIX :: Linux
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
