Metadata-Version: 1.1
Name: nordvpn_converter
Version: 1.0.1
Summary: Conversion tool from OVPN files into NetworkManager compatible. 
Home-page: https://bitbucket.org/cnavalici/nordvpn-converter/
Author: Cristian Năvălici
Author-email: cristian.navalici@gmail.com
License: GNU General Public License v3
Description: ===============================
        NordVPN Configuration Converter
        ===============================
        
        
        .. image:: https://img.shields.io/pypi/v/nordvpn_converter.svg
                :target: https://pypi.python.org/pypi/nordvpn_converter
        
        .. image:: https://readthedocs.org/projects/nordvpn-converter/badge/?version=latest
                :target: https://nordvpn-converter.readthedocs.io/en/latest/?badge=latest
                :alt: Documentation Status
        
        .. image:: https://pyup.io/repos/github/cnavalici/nordvpn_converter/shield.svg
             :target: https://pyup.io/repos/github/cnavalici/nordvpn_converter/
             :alt: Updates
        
        
        Purpose
        -------
        
        The main goal of this small script is to convert the OpenVPN configuration files (provided by the NordVPN_ service) into
        NetworkManager compatible files.
        
        .. _NordVPN: https://nordvpn.com/
        
        
        * Free software: GNU General Public License v3
        * Documentation: https://nordvpn-converter.readthedocs.io.
        * Requires python3
        
        
        Features
        --------
        
        * Bulk conversion done in a matter of seconds
        
        
        ==============
        How to install
        ==============
        
        
        System-wide
        -----------
        
        .. code-block:: console
        
           pip3 install nordvpn_converter
        
        
        Virtual environment
        -------------------
        
        .. code-block:: console
        
           virtualenv --python=python3 nordvpn_converter
           cd nordvpn_converter
           pip install nordvpn_converter
        
        
        From sources
        ------------
        
        The sources for NordVPN Configuration Converter can be downloaded from the `Github repo`_.
        
        You can either clone the public repository:
        
        .. code-block:: console
        
            $ git clone git://github.com/cnavalici/nordvpn_converter
        
        Once you have a copy of the source, you can install it with:
        
        .. code-block:: console
        
            $ python setup.py install
        
        
        .. _Github repo: https://github.com/cnavalici/nordvpn_converter
        
        
        ==========
        How to use
        ==========
        
        
        Grab the required files
        -----------------------
        
        In order to generate the compatible NetworkManager files, you have to login to your NordVPN account, go for **My Account** section, **Download Area**, **Linux** and download *.OVPN configuration files* and *CA & TLS certificates*.
        
        After this, you're gonna end up with 2 archives, **config.zip** and **ca_and_tls_auth_certificates.zip**.
        
        
        Create a new folder and unpack them there:
        
        .. code-block:: console
        
           mkdir ~/NordVPN_Data
           unzip -d ~/NordVPN_Data ~/Downloads/config.zip
           unzip -d ~/NordVPN_Data ~/Downloads/ca_and_tls_auth_certificates.zip
        
        Let's assume that you have now the following structure:
        
        .. code-block:: console
        
            ~/NordVPN_Data/CA\ and\ TLS\ auth\ certificates/*key
            ~/NordVPN_Data/CA\ and\ TLS\ auth\ certificates/*crt
            ~/NordVPN_Data/*.ovpn
        
        
        Run the conversion
        ------------------
        
        The regular help information is available:
        
        .. code-block:: console
        
            usage: nordvpn_converter [-h] [--source SOURCE] [--destination DESTINATION]
                                 [--certs CERTS] [--user USER] [-v] [--version]
        
            This is a simple conversion tool.
        
            optional arguments:
              -h, --help            show this help message and exit
              --source SOURCE       Source folder for ovpn config files
              --destination DESTINATION
                                Destination folder for output files
              --certs CERTS         Source folder for certificates
              --user USER           Username used for the NordVPN connection
              -v, --verbose         Verbose mode
              --version             show program's version number and exit
        
        And based on our example:
        
        .. code-block:: console
        
            nordvpn_converter --source ~/NordVPN_Data --certs ~/NordVPN_Data/CA\ and\ TLS\ auth\ certificates --destination /tmp/output --user jbravo
        
        Just note that the *user* is not the local one, but the NordVPN one. The files will be automatically generated with the current local username.
        
        The *ouput* folder will contain now a lot of NetworkManager compatible files.
        
        Install the NetworkManager files
        --------------------------------
        
        Move the output files into NetworkManager connections folder and then process them.
        
        .. code-block:: console
        
           cp /tmp/output/* /etc/NetworkManager/system-connections
           chmod 600 *
           nmcli conn reload
        
        Now you should be able to see those connections also in the NetworkManager applet from your graphical environment.
        
        =======
        Credits
        =======
        
        This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
        
        .. _Cookiecutter: https://github.com/audreyr/cookiecutter
        .. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
        
        =======
        History
        =======
        
        0.1 (2016-11-28)
        ------------------
        
        * First release on PyPI.
        
Keywords: nordvpn_converter
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
