# NordVPN Tray
### A cross-platform system tray application for interacting with Nord VPN.
[](https://github.com/aviolaris/nordvpn-tray)
[](https://pypistats.org/packages/nordvpn-tray)
[](https://github.com/aviolaris/nordvpn-tray/blob/master/LICENSE)
[](https://github.com/aviolaris/nordvpn-tray/stargazers)
## Description
The official NordVPN clients for both Windows and Linux have well-known limitations. For instance, in Windows, to list
all servers of a specific country, you must use a search pattern like ```country_name #```, while in Linux, it is not
possible at all. Furthermore, regardless of the platform, these clients do not provide essential information such as the
server's load and external IP, even if the user has the corresponding identification code.
To overcome these limitations, the current project expands the functionality of the official clients by introducing a
solution in the form of a cross-platform system tray application. By placing an icon in the system tray, users can
easily access a menu displaying the complete list of available NordVPN servers. The servers are conveniently categorized
by continents and countries, allowing for effortless navigation. Moreover, they are ordered by their load, enabling
users to select the server with the lowest load for optimal performance.
## Preview
<img src="https://github.com/aviolaris/nordvpn-tray/assets/48277853/b4458286-efa2-4e0d-99e2-948d8df8aca8" alt="Preview" width="500">
## Requirements
- The official NordVPN client (available [here](https://nordvpn.com/download/))
## Installation
To install NordVPN Tray, run the following command:
pip install nordvpn-tray
## Usage
To launch NordVPN Tray:
- **On Windows**, double-click the `nordvpn-tray.exe` (usually located
in `%LOCALAPPDATA%\Programs\Python\Python##\Scripts`) or run the `nordvpn-tray` command from the command prompt.
- **On Linux**, double-click the `nordvpn-tray` (usually located in `~/.local/bin`) or run the `./nordvpn-tray` command
from the terminal.
## Common Issues
#### "ValueError: Namespace AppIndicator3 not available" (Linux Only)
This error message indicates that the `AppIndicator3` module, which the application uses to display tray icons on Linux,
is not available on your system.
To resolve this issue, you will need to install the `libayatana-appindicator3-dev` package, which provides the necessary
files and libraries for the `AppIndicator3` module. To install the package, use the following command:
sudo apt-get install libayatana-appindicator3-dev
## Disclaimer
All trademarks, logos and brand names are the property of their respective owners. All company and service names used in
this repository are for identification purposes only. The use of NordVPN trademarks does not imply any endorsement,
partnership, or sponsorship by Nordsec Ltd.
## Contribution
Pull requests and issues are welcome.
## License
This project is licensed under the GNU General Public License v3.0.
See the [LICENSE](https://github.com/aviolaris/nordvpn-tray/blob/main/LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/aviolaris/nordvpn-tray",
"name": "nordvpn-tray",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "nord,nordvpn,nordvpn-tray,nordvpn_tray,vpn,vpn-client,tray,python,pypi,python3,tray,tray-application,pypi-package,tray-app",
"author": "Andreas Violaris",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/26/67/26492ca1875e24c3b12be83d3abc6f39f83d712392fa985408c8382e431c/nordvpn-tray-1.0.11.tar.gz",
"platform": null,
"description": "# NordVPN Tray\r\n\r\n### A cross-platform system tray application for interacting with Nord VPN.\r\n\r\n[](https://github.com/aviolaris/nordvpn-tray)\r\n\r\n\r\n[](https://pypistats.org/packages/nordvpn-tray)\r\n\r\n[](https://github.com/aviolaris/nordvpn-tray/blob/master/LICENSE)\r\n\r\n\r\n[](https://github.com/aviolaris/nordvpn-tray/stargazers)\r\n\r\n## Description\r\n\r\nThe official NordVPN clients for both Windows and Linux have well-known limitations. For instance, in Windows, to list\r\nall servers of a specific country, you must use a search pattern like ```country_name #```, while in Linux, it is not\r\npossible at all. Furthermore, regardless of the platform, these clients do not provide essential information such as the\r\nserver's load and external IP, even if the user has the corresponding identification code.\r\n\r\nTo overcome these limitations, the current project expands the functionality of the official clients by introducing a\r\nsolution in the form of a cross-platform system tray application. By placing an icon in the system tray, users can\r\neasily access a menu displaying the complete list of available NordVPN servers. The servers are conveniently categorized\r\nby continents and countries, allowing for effortless navigation. Moreover, they are ordered by their load, enabling\r\nusers to select the server with the lowest load for optimal performance.\r\n\r\n## Preview\r\n\r\n<img src=\"https://github.com/aviolaris/nordvpn-tray/assets/48277853/b4458286-efa2-4e0d-99e2-948d8df8aca8\" alt=\"Preview\" width=\"500\">\r\n\r\n## Requirements\r\n\r\n- The official NordVPN client (available [here](https://nordvpn.com/download/))\r\n\r\n## Installation\r\n\r\nTo install NordVPN Tray, run the following command:\r\n\r\n pip install nordvpn-tray\r\n\r\n## Usage\r\n\r\nTo launch NordVPN Tray:\r\n\r\n- **On Windows**, double-click the `nordvpn-tray.exe` (usually located\r\n in `%LOCALAPPDATA%\\Programs\\Python\\Python##\\Scripts`) or run the `nordvpn-tray` command from the command prompt.\r\n\r\n\r\n- **On Linux**, double-click the `nordvpn-tray` (usually located in `~/.local/bin`) or run the `./nordvpn-tray` command\r\n from the terminal.\r\n\r\n## Common Issues\r\n\r\n#### \"ValueError: Namespace AppIndicator3 not available\" (Linux Only)\r\n\r\nThis error message indicates that the `AppIndicator3` module, which the application uses to display tray icons on Linux,\r\nis not available on your system.\r\n\r\nTo resolve this issue, you will need to install the `libayatana-appindicator3-dev` package, which provides the necessary\r\nfiles and libraries for the `AppIndicator3` module. To install the package, use the following command:\r\n\r\n sudo apt-get install libayatana-appindicator3-dev\r\n\r\n## Disclaimer\r\n\r\nAll trademarks, logos and brand names are the property of their respective owners. All company and service names used in\r\nthis repository are for identification purposes only. The use of NordVPN trademarks does not imply any endorsement,\r\npartnership, or sponsorship by Nordsec Ltd.\r\n\r\n## Contribution\r\n\r\nPull requests and issues are welcome.\r\n\r\n## License\r\n\r\nThis project is licensed under the GNU General Public License v3.0.\r\n\r\nSee the [LICENSE](https://github.com/aviolaris/nordvpn-tray/blob/main/LICENSE) file for details.\r\n",
"bugtrack_url": null,
"license": "",
"summary": "A cross-platform system tray application for interacting with NordVPN.",
"version": "1.0.11",
"project_urls": {
"Homepage": "https://github.com/aviolaris/nordvpn-tray"
},
"split_keywords": [
"nord",
"nordvpn",
"nordvpn-tray",
"nordvpn_tray",
"vpn",
"vpn-client",
"tray",
"python",
"pypi",
"python3",
"tray",
"tray-application",
"pypi-package",
"tray-app"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "00c756f81d5f1882b372dab3ff881c0081fec583461cabdaf9ab85b83930295b",
"md5": "409dabd9701d4e4f5a431fafbcbf009c",
"sha256": "1452578d16c6eb96e77430ce8075ffe6d0e6808eaba56b629e4a43101deb7bf1"
},
"downloads": -1,
"filename": "nordvpn_tray-1.0.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "409dabd9701d4e4f5a431fafbcbf009c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 51291,
"upload_time": "2024-02-28T13:41:19",
"upload_time_iso_8601": "2024-02-28T13:41:19.226208Z",
"url": "https://files.pythonhosted.org/packages/00/c7/56f81d5f1882b372dab3ff881c0081fec583461cabdaf9ab85b83930295b/nordvpn_tray-1.0.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "266726492ca1875e24c3b12be83d3abc6f39f83d712392fa985408c8382e431c",
"md5": "d3005dfb05aa232c7be171242f1ccfa8",
"sha256": "dc08225873e068c6e1cd4d0ef5f37bd3b16f735c66d49a7f4d4cd8e0256fe9df"
},
"downloads": -1,
"filename": "nordvpn-tray-1.0.11.tar.gz",
"has_sig": false,
"md5_digest": "d3005dfb05aa232c7be171242f1ccfa8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 54014,
"upload_time": "2024-02-28T13:41:20",
"upload_time_iso_8601": "2024-02-28T13:41:20.555656Z",
"url": "https://files.pythonhosted.org/packages/26/67/26492ca1875e24c3b12be83d3abc6f39f83d712392fa985408c8382e431c/nordvpn-tray-1.0.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-28 13:41:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aviolaris",
"github_project": "nordvpn-tray",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "country_converter",
"specs": [
[
"==",
"1.2"
]
]
},
{
"name": "Pillow",
"specs": [
[
"==",
"10.2.0"
]
]
},
{
"name": "pystray",
"specs": [
[
"==",
"0.19.5"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.31.0"
]
]
},
{
"name": "setuptools",
"specs": [
[
"==",
"69.1.1"
]
]
}
],
"tox": true,
"lcname": "nordvpn-tray"
}
JSON
