meile-gui


Namemeile-gui JSON
Version 0.15.0.1 PyPI version JSON
download
home_pagehttps://meile.app
SummaryMeile dVPN powered by the Sentinel Network
upload_time2024-01-28 06:05:34
maintainer
docs_urlNone
authorMathNodes
requires_python
licenseGNU General Public License (GPL)
keywords vpn dvpn sentinel crypto gui privacy security decentralized
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            Meile-GUI (may•lah)
========================

[![Github All Releases](https://img.shields.io/github/downloads/mathnodes/meile-gui/total?style=for-the-badge)](https://github.com/MathNodes/meile-gui/releases)
[![GitHub license](https://img.shields.io/github/license/mathnodes/meile-gui?style=for-the-badge)](https://github.com/MathNodes/meile-gui/blob/main/LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/mathnodes/meile-gui?style=for-the-badge)](https://github.com/mathnodes/meile-gui/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/mathnodes/meile-gui?style=for-the-badge)](https://github.com/mathnodes/meile-gui/network)
[![GitHub issues](https://img.shields.io/github/issues/mathnodes/meile-gui?style=for-the-badge)](https://github.com/mathnodes/meile-gui/issues)

[![Downloads](https://static.pepy.tech/personalized-badge/meile-gui?period=total&units=international_system&left_color=black&right_color=orange&left_text=pip)](https://pepy.tech/project/meile-gui)
[![Downloads](https://static.pepy.tech/personalized-badge/meile-gui?period=month&units=international_system&left_color=black&right_color=orange&left_text=pip%20(month))](https://pepy.tech/project/meile-gui)

Meile dVPN GUI for Linux, OS X, and Windows - Powered by the Sentinel Network - a blockchain decentralized VPN. 

# Full Version

The full version 1.8.0 has been released to GitHub. Branches include **main**, **osx-fiat-intel**, **windows**, **fiat**, **osx-fiat**, **pip**. The exception is that we did not include the scrtsxx.py which contains credentials for the FIAT gateway. Please navigate the various branches to understand the different interworkings. It is our intention to eventually merge all branches into a unified code source. 

## Windows

The current release is version **1.8.0**. Please note this does not use Windows APIs to ask for Administration privleges and relies on an open source implementation called "gsudo". Gsudo is just a hack to ask the user to modify network adapters so that Meile may connect without issue. 

Also, Meile opens a debug console in the background. Do not close this otherwise the app will close as well. We are working on getting a Microsoft Developers Certificate so we may sign the app for official release. Also, when we get the certificate we will eliminate the debug console as well. This is all in the works. 

Download: [Meile for Windows (v1.8.0)](https://github.com/MathNodes/meile-gui/releases/tag/v1.8.0)

## Mac OS X

Download the latest release as a DMG: [Mac OS X v1.8.0](https://github.com/MathNodes/meile-gui/releases/tag/v1.8.0)

The OS X M1/M2 and Intel builds are packaged as a disk image (DMG). To install, simply download the correct DMG for your architecture (Intel or Apple Silicon). Double click on the DMG file and move the Meile app bundle to your desktop or to the Applications folder. 

Both the OS X Intel and Apple Silicon release are signed by a Apple Developer Certificate. There should be no errors when running these. 

### NOTE:

pip install is not currently available for Mac OS X. We are working on bringing this as a separate packages. 

## Debian .deb package

The latest version of Meile GUI comes packaged as a Debian archive. Simply download the latest release: [Meile Releases](https://github.com/MathNodes/meile-gui/releases/)

and run apt for your build:

```shell
sudo apt install -y ./meile-gui-v1.8.0_ubuntu22.04_amd64.deb
```

This release will install wireguard tools, resolvconf, curl, and net-tools alongside the Meile GUI. To connect to nodes or disconnect requires "sudo" privileges. You will be prompted by your system dialog to enter your username's password to give authorization to complete the connection. This is due to how Linux handles permissions with regards to network interfaces. 

### Run

```shell
meile-gui
```

Or goto your panel menu under Internet and there will be a clickable icon. 

## Debian Virtual Machine (.deb)

Because there were issues loading certain mesa OpenGL drivers in various Debian Virtual Machines, we have included a separate .deb archive that automatically configures the system to handle the Meile dependencies. Please use this version if you are running a Debian flavor in a virutal machine (VM).

[Debian/Ubuntu 20.04 Virtual Machine](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0_ubuntu2004_amd64_vm.deb)

[Debian/Ubuntu 22.04 Virtual Machine](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0_ubuntu2204_amd64_vm.deb)

## Redhat/CentOS/Fedora (.rpm)

Download the latest RPM for RedHat releases:

[RedHat RPM (fc36)](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0-1.fc36.x86_64.rpm)

[RedHat RPM (fc37)](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0-1.fc37.x86_64.rpm)

Install the rpm from a terminal via *dnf* (**RECOMMENDED**):

```shell
sudo dnf install meile-gui-v1.8.0-1.fc36.x86_64.rpm
```

or via *rpm*:

```shell
sudo rpm -i meile-gui-v1.8.0-1.fc36.x86_64.rpm
```

*dnf* is **recommended** as it will install all dependencies for Meile to function correctly.

## Installing via pip

Meile dVPN GUI v0.14.1 is now available as a pip packages as well. These are pre-releases scheduled to be built into a binary. First install system dependencies:

```shell
sudo apt install -y  wireguard-tools openresolv mesa-utils libgl1-mesa-glx xclip python3-devel curl net-tools python3-venv
```

Then install via pip

```shell
pip3 install meile-gui
```

via a virtual environment:

```shell
mkdir ~/venv && python3 -m venv ~/venv/meile
source venv/meile/bin/activate
pip3 install meile-gui
```

Upgrade via pip

```shell
pip3 install meile-gui --upgrade
```

To run Meile GUI after pip install do the following:

```shell
meile-gui
```

### NOTE:

The FIAT gateway is not included in the pip package. This is due to certain credentials needing to remain secret for OPSEC reasons. The pip package will continue to get updated with the FIAT release with bug fixes and feature additions. 

We consider the pip releases to be pre-releases of the compiled binaries. Pip is considered the bleeding edge of Meile releases



### Packaged Binaries

We package the following binaries with our releases:

* tun2socks([GitHub - xjasonlyu/tun2socks: tun2socks - powered by gVisor TCP/IP stack](https://github.com/xjasonlyu/tun2socks))

* v2ray ([GitHub - v2fly/v2ray-core: A platform for building proxies to bypass network restrictions.](https://github.com/v2fly/v2ray-core))

* sentinel-cli ([GitHub - sentinel-official/cli-client: The official Sentinel CLI client](https://github.com/sentinel-official/cli-client))

* warp ([Download WARP · Cloudflare Zero Trust docs](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/download-warp/))

We have built tun2socks, v2ray, and sentinel-cli from source on the target architectures. Cloudflare warp is closed-source and so we packaged the binaries direct from the install link above. 


**Note:** we use **v2ray** version **5.1.0** as this is what the dvpn-node software also uses and it is recommended to use the same client version as the server version.

## Help

Please make comments, suggestions, and issues on the issues page here at GitHub. If you are a GitHub newb, you can join us in our various open messaging channels:

* Telegram [MathNodes-Telegram](http://t.me/MathNodes)
* Discord [MathNodes-Discord](https://discord.gg/HQrHXZJHQq) in the Meile channel, 
* Session [Session Open Group](http://session.mathnodes.com/mathnodes-dvpn-oxen-dero?public_key=8585d7f3fb44f4f40fb1685a0cf10627dd24467a9379eafbb7ba08e5607e9c21)

Session:
![session](./img/session_qr.png)

All suggestions are welcome.

## Creating a Binary for your distribution:

In order to create a binary for your distribution some packages need to be installed first.

Pyinstaller:

```shell
pip3 install pyinstaller
```

Install a python virtualenv:

```shell
sudo apt install python3-venv
```

Then clone the repo:

```shell
git clone https://github.com/MathNodes/meile-gui
```

Switch to the pip branch as this is the one without FIAT gateway

```
cd meile-gui && git checkout pip
```

Then run a python virtual environment and install meile-gui. This will find all the dependencies for **meile-gui**.

```shell
python3 -m venv meile-gui && \
source meile-gui/bin/activate && \ 
pip install -r requriements.txt  && pip install -e .
```

Once meile-gui and it's dependencies have been installed within the python virutal environment, a binary release can be created:

```
bash pyinstaller.cmd
```

That's it. Navigate to the `dist` folder where the binary will be. 

### Windows

For windows, install the necessary pip packages found in `setup.py` and run the following with `pyinstaller`

```shell
pyinstaller meile_gui.spec
```

This will build the binary found in the `dist` directory of the Meile tree. 

# Donations

Because we are working on a small grant with no VC funding, any additional contributions to our developer team is more than certainly welcomed. It will help fund future releases. 

## BTC (Bitcoin)

```
bc1qtvc9l3cr9u4qg6uwe6pvv7jufvsnn0xxpdyftl
```

![BTC](./img/BTC.png)

## DVPN (Sentinel)

```
sent12v8ghhg98e2n0chyje3su4uqlsg75sh4lwcyww
```

![dvpn](./img/DVPN.png)

## XMR (Monero)

```
87qHJPU5dZGWaWzuoC3My5SgoQSuxh4sHSv1FXRZrQ9XZHWnfC33EX1NLv5HujpVhbPbbF9RcXXD94byT18HonAQ75b9dyR
```

![xmr](./img/XMR.png)

## ARRR (Pirate Chain)

```
zs1gn457262c52z5xa666k77zafqmke0hd60qvc38dk48w9fx378h4zjs5rrwnl0x8qazj4q3x4svz
```

![ARRR](./img/ARRR.png)

            

Raw data

            {
    "_id": null,
    "home_page": "https://meile.app",
    "name": "meile-gui",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "vpn,dvpn,sentinel,crypto,gui,privacy,security,decentralized",
    "author": "MathNodes",
    "author_email": "freQniK@mathnodes.com",
    "download_url": "https://files.pythonhosted.org/packages/8c/9a/526062e6c486d31f88b63b4e72fb23ee53819a2a623bd889ce81c01139de/meile-gui-0.15.0.1.tar.gz",
    "platform": null,
    "description": "Meile-GUI (may\u2022lah)\n========================\n\n[![Github All Releases](https://img.shields.io/github/downloads/mathnodes/meile-gui/total?style=for-the-badge)](https://github.com/MathNodes/meile-gui/releases)\n[![GitHub license](https://img.shields.io/github/license/mathnodes/meile-gui?style=for-the-badge)](https://github.com/MathNodes/meile-gui/blob/main/LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/mathnodes/meile-gui?style=for-the-badge)](https://github.com/mathnodes/meile-gui/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/mathnodes/meile-gui?style=for-the-badge)](https://github.com/mathnodes/meile-gui/network)\n[![GitHub issues](https://img.shields.io/github/issues/mathnodes/meile-gui?style=for-the-badge)](https://github.com/mathnodes/meile-gui/issues)\n\n[![Downloads](https://static.pepy.tech/personalized-badge/meile-gui?period=total&units=international_system&left_color=black&right_color=orange&left_text=pip)](https://pepy.tech/project/meile-gui)\n[![Downloads](https://static.pepy.tech/personalized-badge/meile-gui?period=month&units=international_system&left_color=black&right_color=orange&left_text=pip%20(month))](https://pepy.tech/project/meile-gui)\n\nMeile dVPN GUI for Linux, OS X, and Windows - Powered by the Sentinel Network - a blockchain decentralized VPN. \n\n# Full Version\n\nThe full version 1.8.0 has been released to GitHub. Branches include **main**, **osx-fiat-intel**, **windows**, **fiat**, **osx-fiat**, **pip**. The exception is that we did not include the scrtsxx.py which contains credentials for the FIAT gateway. Please navigate the various branches to understand the different interworkings. It is our intention to eventually merge all branches into a unified code source. \n\n## Windows\n\nThe current release is version **1.8.0**. Please note this does not use Windows APIs to ask for Administration privleges and relies on an open source implementation called \"gsudo\". Gsudo is just a hack to ask the user to modify network adapters so that Meile may connect without issue. \n\nAlso, Meile opens a debug console in the background. Do not close this otherwise the app will close as well. We are working on getting a Microsoft Developers Certificate so we may sign the app for official release. Also, when we get the certificate we will eliminate the debug console as well. This is all in the works. \n\nDownload: [Meile for Windows (v1.8.0)](https://github.com/MathNodes/meile-gui/releases/tag/v1.8.0)\n\n## Mac OS X\n\nDownload the latest release as a DMG: [Mac OS X v1.8.0](https://github.com/MathNodes/meile-gui/releases/tag/v1.8.0)\n\nThe OS X M1/M2 and Intel builds are packaged as a disk image (DMG). To install, simply download the correct DMG for your architecture (Intel or Apple Silicon). Double click on the DMG file and move the Meile app bundle to your desktop or to the Applications folder. \n\nBoth the OS X Intel and Apple Silicon release are signed by a Apple Developer Certificate. There should be no errors when running these. \n\n### NOTE:\n\npip install is not currently available for Mac OS X. We are working on bringing this as a separate packages. \n\n## Debian .deb package\n\nThe latest version of Meile GUI comes packaged as a Debian archive. Simply download the latest release: [Meile Releases](https://github.com/MathNodes/meile-gui/releases/)\n\nand run apt for your build:\n\n```shell\nsudo apt install -y ./meile-gui-v1.8.0_ubuntu22.04_amd64.deb\n```\n\nThis release will install wireguard tools, resolvconf, curl, and net-tools alongside the Meile GUI. To connect to nodes or disconnect requires \"sudo\" privileges. You will be prompted by your system dialog to enter your username's password to give authorization to complete the connection. This is due to how Linux handles permissions with regards to network interfaces. \n\n### Run\n\n```shell\nmeile-gui\n```\n\nOr goto your panel menu under Internet and there will be a clickable icon. \n\n## Debian Virtual Machine (.deb)\n\nBecause there were issues loading certain mesa OpenGL drivers in various Debian Virtual Machines, we have included a separate .deb archive that automatically configures the system to handle the Meile dependencies. Please use this version if you are running a Debian flavor in a virutal machine (VM).\n\n[Debian/Ubuntu 20.04 Virtual Machine](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0_ubuntu2004_amd64_vm.deb)\n\n[Debian/Ubuntu 22.04 Virtual Machine](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0_ubuntu2204_amd64_vm.deb)\n\n## Redhat/CentOS/Fedora (.rpm)\n\nDownload the latest RPM for RedHat releases:\n\n[RedHat RPM (fc36)](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0-1.fc36.x86_64.rpm)\n\n[RedHat RPM (fc37)](https://github.com/MathNodes/meile-gui/releases/download/v1.8.0/meile-gui-v1.8.0-1.fc37.x86_64.rpm)\n\nInstall the rpm from a terminal via *dnf* (**RECOMMENDED**):\n\n```shell\nsudo dnf install meile-gui-v1.8.0-1.fc36.x86_64.rpm\n```\n\nor via *rpm*:\n\n```shell\nsudo rpm -i meile-gui-v1.8.0-1.fc36.x86_64.rpm\n```\n\n*dnf* is **recommended** as it will install all dependencies for Meile to function correctly.\n\n## Installing via pip\n\nMeile dVPN GUI v0.14.1 is now available as a pip packages as well. These are pre-releases scheduled to be built into a binary. First install system dependencies:\n\n```shell\nsudo apt install -y  wireguard-tools openresolv mesa-utils libgl1-mesa-glx xclip python3-devel curl net-tools python3-venv\n```\n\nThen install via pip\n\n```shell\npip3 install meile-gui\n```\n\nvia a virtual environment:\n\n```shell\nmkdir ~/venv && python3 -m venv ~/venv/meile\nsource venv/meile/bin/activate\npip3 install meile-gui\n```\n\nUpgrade via pip\n\n```shell\npip3 install meile-gui --upgrade\n```\n\nTo run Meile GUI after pip install do the following:\n\n```shell\nmeile-gui\n```\n\n### NOTE:\n\nThe FIAT gateway is not included in the pip package. This is due to certain credentials needing to remain secret for OPSEC reasons. The pip package will continue to get updated with the FIAT release with bug fixes and feature additions. \n\nWe consider the pip releases to be pre-releases of the compiled binaries. Pip is considered the bleeding edge of Meile releases\n\n\n\n### Packaged Binaries\n\nWe package the following binaries with our releases:\n\n* tun2socks([GitHub - xjasonlyu/tun2socks: tun2socks - powered by gVisor TCP/IP stack](https://github.com/xjasonlyu/tun2socks))\n\n* v2ray ([GitHub - v2fly/v2ray-core: A platform for building proxies to bypass network restrictions.](https://github.com/v2fly/v2ray-core))\n\n* sentinel-cli ([GitHub - sentinel-official/cli-client: The official Sentinel CLI client](https://github.com/sentinel-official/cli-client))\n\n* warp ([Download WARP \u00b7 Cloudflare Zero Trust docs](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/download-warp/))\n\nWe have built tun2socks, v2ray, and sentinel-cli from source on the target architectures. Cloudflare warp is closed-source and so we packaged the binaries direct from the install link above. \n\n\n**Note:** we use **v2ray** version **5.1.0** as this is what the dvpn-node software also uses and it is recommended to use the same client version as the server version.\n\n## Help\n\nPlease make comments, suggestions, and issues on the issues page here at GitHub. If you are a GitHub newb, you can join us in our various open messaging channels:\n\n* Telegram [MathNodes-Telegram](http://t.me/MathNodes)\n* Discord [MathNodes-Discord](https://discord.gg/HQrHXZJHQq) in the Meile channel, \n* Session [Session Open Group](http://session.mathnodes.com/mathnodes-dvpn-oxen-dero?public_key=8585d7f3fb44f4f40fb1685a0cf10627dd24467a9379eafbb7ba08e5607e9c21)\n\nSession:\n![session](./img/session_qr.png)\n\nAll suggestions are welcome.\n\n## Creating a Binary for your distribution:\n\nIn order to create a binary for your distribution some packages need to be installed first.\n\nPyinstaller:\n\n```shell\npip3 install pyinstaller\n```\n\nInstall a python virtualenv:\n\n```shell\nsudo apt install python3-venv\n```\n\nThen clone the repo:\n\n```shell\ngit clone https://github.com/MathNodes/meile-gui\n```\n\nSwitch to the pip branch as this is the one without FIAT gateway\n\n```\ncd meile-gui && git checkout pip\n```\n\nThen run a python virtual environment and install meile-gui. This will find all the dependencies for **meile-gui**.\n\n```shell\npython3 -m venv meile-gui && \\\nsource meile-gui/bin/activate && \\ \npip install -r requriements.txt  && pip install -e .\n```\n\nOnce meile-gui and it's dependencies have been installed within the python virutal environment, a binary release can be created:\n\n```\nbash pyinstaller.cmd\n```\n\nThat's it. Navigate to the `dist` folder where the binary will be. \n\n### Windows\n\nFor windows, install the necessary pip packages found in `setup.py` and run the following with `pyinstaller`\n\n```shell\npyinstaller meile_gui.spec\n```\n\nThis will build the binary found in the `dist` directory of the Meile tree. \n\n# Donations\n\nBecause we are working on a small grant with no VC funding, any additional contributions to our developer team is more than certainly welcomed. It will help fund future releases. \n\n## BTC (Bitcoin)\n\n```\nbc1qtvc9l3cr9u4qg6uwe6pvv7jufvsnn0xxpdyftl\n```\n\n![BTC](./img/BTC.png)\n\n## DVPN (Sentinel)\n\n```\nsent12v8ghhg98e2n0chyje3su4uqlsg75sh4lwcyww\n```\n\n![dvpn](./img/DVPN.png)\n\n## XMR (Monero)\n\n```\n87qHJPU5dZGWaWzuoC3My5SgoQSuxh4sHSv1FXRZrQ9XZHWnfC33EX1NLv5HujpVhbPbbF9RcXXD94byT18HonAQ75b9dyR\n```\n\n![xmr](./img/XMR.png)\n\n## ARRR (Pirate Chain)\n\n```\nzs1gn457262c52z5xa666k77zafqmke0hd60qvc38dk48w9fx378h4zjs5rrwnl0x8qazj4q3x4svz\n```\n\n![ARRR](./img/ARRR.png)\n",
    "bugtrack_url": null,
    "license": "GNU General Public License (GPL)",
    "summary": "Meile dVPN powered by the Sentinel Network",
    "version": "0.15.0.1",
    "project_urls": {
        "Homepage": "https://meile.app"
    },
    "split_keywords": [
        "vpn",
        "dvpn",
        "sentinel",
        "crypto",
        "gui",
        "privacy",
        "security",
        "decentralized"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "726382e449c747a173a9ffa5602e2b71f5c5968f8ae70f39a000b957f80c03b5",
                "md5": "54ca120614bb89f72f9dd979b888c10c",
                "sha256": "92f40f77bc1c5330742646f497b59b12a8bd029bdc7cd57c4c0499828167df43"
            },
            "downloads": -1,
            "filename": "meile_gui-0.15.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "54ca120614bb89f72f9dd979b888c10c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 49254896,
            "upload_time": "2024-01-28T06:05:10",
            "upload_time_iso_8601": "2024-01-28T06:05:10.554363Z",
            "url": "https://files.pythonhosted.org/packages/72/63/82e449c747a173a9ffa5602e2b71f5c5968f8ae70f39a000b957f80c03b5/meile_gui-0.15.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8c9a526062e6c486d31f88b63b4e72fb23ee53819a2a623bd889ce81c01139de",
                "md5": "3a0507440851719352888e6e8a8f79ff",
                "sha256": "51fa3252cf1bd809ce9ca3cb536b4ebfbc3180d9727a3de1cd3cc844e5683571"
            },
            "downloads": -1,
            "filename": "meile-gui-0.15.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "3a0507440851719352888e6e8a8f79ff",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 48934973,
            "upload_time": "2024-01-28T06:05:34",
            "upload_time_iso_8601": "2024-01-28T06:05:34.407636Z",
            "url": "https://files.pythonhosted.org/packages/8c/9a/526062e6c486d31f88b63b4e72fb23ee53819a2a623bd889ce81c01139de/meile-gui-0.15.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-28 06:05:34",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "meile-gui"
}
        
Elapsed time: 0.97561s