{"id":17623736,"url":"https://github.com/jbweston/nord","last_synced_at":"2025-06-11T03:36:34.015Z","repository":{"id":57446673,"uuid":"102720992","full_name":"jbweston/nord","owner":"jbweston","description":"An unofficial NordVPN client [DEPRECATED]","archived":false,"fork":false,"pushed_at":"2021-04-13T15:03:36.000Z","size":139,"stargazers_count":28,"open_issues_count":9,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-02T01:40:21.882Z","etag":null,"topics":["deprecated","nordvpn"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jbweston.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-07T09:53:42.000Z","updated_at":"2024-09-03T19:44:11.000Z","dependencies_parsed_at":"2022-09-05T09:40:37.839Z","dependency_job_id":null,"html_url":"https://github.com/jbweston/nord","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbweston%2Fnord","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbweston%2Fnord/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbweston%2Fnord/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbweston%2Fnord/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jbweston","download_url":"https://codeload.github.com/jbweston/nord/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbweston%2Fnord/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259192202,"owners_count":22819433,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deprecated","nordvpn"],"created_at":"2024-10-22T21:42:38.360Z","updated_at":"2025-06-11T03:36:33.984Z","avatar_url":"https://github.com/jbweston.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Nord: an unofficial NordVPN client\n==================================\n\n.. badges-start\n\n.. image:: https://img.shields.io/badge/License-GPL%20v3-blue.svg\n   :target: https://img.shields.io/badge/License-GPL%20v3-blue.svg\n   :alt: GPLv3 License\n\n.. image:: https://badge.fury.io/py/nord.svg\n   :target: https://badge.fury.io/py/nord\n   :alt: PyPi package\n\n.. image:: https://readthedocs.org/projects/nord/badge/?version=stable\n   :target: http://nord.readthedocs.io/en/stable/?badge=stable\n   :alt: Documentation Status\n\n.. badges-end\n.. doc-start\n\n**DEPRECATION NOTICE: This repository will no longer be actively worked on now that NordVPN has an official Linux client: https://support.nordvpn.com/Connectivity/Linux/**\n\nOverview\n--------\n\n.. overview\n\nNord is a client for interacting with the `NordVPN`_ service.\n\nAt its core is a high-level Python API for interacting both with the web service\nprovided by NordVPN, and for connecting to VPN servers using OpenVPN.\n\nNord also contains components that expose this API as a command line tool,\nand (soon) as a web service and frontend.\n\n.. _NordVPN: https://nordvpn.com\n\n.. overview-end\n\nLicence\n-------\nNord is licensed under the terms of the GNU GPLv3.\nSee the LICENSE_ file for details.\n\nThe file ``web/static/world.geo.json`` is Copyright (c) 2017 Richard Zimmerman\nand is included here under the conditions of the `MIT License`_\n\n.. _LICENSE: LICENSE\n.. _MIT License: web/static/LICENSE\n\nInstallation\n------------\n::\n\n    pip install nord\n\nUsage\n-----\n\nRun ``nord --help`` for the full usage instructions.\n\nConnect to a specific NordVPN server::\n\n    nord connect -u my_user -p my_password us893\n\nConnect to any NordVPN server in a given country::\n\n    nord connect -u my_user -p my_password US\n\nServe a web app that allows you to select the country to\nwhich you wish to connect::\n\n    nord web -u my_user -p my_password\n\nYou can also supply your password from a file using the ``-f`` flag.\nThe special value ``-`` means \"read from stdin\". This is particularly\nuseful when your password is stored in a utility such as\npass_::\n\n    pass nordvpn_password | nord connect -u my_user -f - us893\n\n.. _pass: https://www.passwordstore.org/\n\nPrerequesites\n-------------\n- GNU/Linux system\n- Python 3.6\n- ``openvpn``\n- ``sudo``\n\nnord contains many Linux-isms (e.g. using the ``sudo`` program to obtain root\naccess) so it will certainly not work on Windows, it may possibly work\non OSX and \\*BSD, but support for these platforms is not a goal.\n\nMost recent versions of popular GNU/Linux distributions (with the\nexception of Debian) have both an OpenVPN client and Python 3.6\nin their official repositories. Debian users will have to take\n`additional steps`_ to get a Python 3.6 installation.\n\n.. _additional steps: Debian_\n\n\nUbuntu 16.10 and newer\n**********************\nUbuntu comes with ``sudo`` already installed, so we just need\nto install Python and openVPN::\n\n    sudo apt-get install python3.6 openvpn\n\nFedora 26 and newer\n*******************\nFedora comes with ``sudo`` already installed, so we just need\nto install Python and openVPN::\n\n    sudo dnf install python36 openvpn\n\nArch Linux\n**********\nRun the following as root::\n\n    pacman -S sudo python openvpn\n\nThen configure ``sudo`` by following the `Arch wiki`_\nto give privileges to the user that nord will be running as.\n\n.. _Arch wiki: https://wiki.archlinux.org/index.php/sudo\n\nDebian\n******\nFirst run the following as root to install the openVPN client and\n``sudo`` from the Debian repositories::\n\n    apt install sudo openvpn\n\nThen configure ``sudo`` by following the `Debian wiki`_\nto give privileges to the user that nord will be running as.\n\nThere are a couple of options for installing Python3.6 on Debian:\n\n- Installing from the ``unstable`` repositories\n- Installing from source (easier than you might think\n\nBoth of these methods are explained in top-rated answers to this\n`stackexchange question`_.\n\n.. _Debian wiki: https://wiki.debian.org/sudo\n.. _stackexchange question:  https://unix.stackexchange.com/questions/332641/how-to-install-python-3-6\n\nDeveloping\n----------\nYou will need Python 3.6 and Yarn_ (for the web components).\n::\n\n    git clone https://github.com/jbweston/nord\n    cd nord\n    virtualenv -p python3.6\n    source venv/bin/activate\n    pip install -e .[dev]\n    yarn install\n\nPeriodically check your code with the linter::\n\n    pylint nord\n\nWeb components\n**************\nWhen developing the web frontend you can execute the following command\nto run an auto-reloading web server::\n\n    yarn dev\n\n.. _Yarn: https://yarnpkg.com/en/docs/install\n\nBuilding the API documentation\n******************************\n::\n\n    make -C docs html\n    xdg-open docs/build/html/index.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjbweston%2Fnord","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjbweston%2Fnord","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjbweston%2Fnord/lists"}