{"id":13647345,"url":"https://github.com/Rafficer/linux-cli-community","last_synced_at":"2025-04-22T02:31:25.150Z","repository":{"id":39648025,"uuid":"211895509","full_name":"Rafficer/linux-cli-community","owner":"Rafficer","description":"Linux command-line client for ProtonVPN. Written in Python.","archived":false,"fork":false,"pushed_at":"2025-02-12T16:53:20.000Z","size":726,"stargazers_count":1347,"open_issues_count":140,"forks_count":205,"subscribers_count":49,"default_branch":"master","last_synced_at":"2025-04-13T21:33:49.467Z","etag":null,"topics":["linux","openvpn","protonvpn","protonvpn-cli","python","python3","vpn"],"latest_commit_sha":null,"homepage":"https://protonvpn.com","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/Rafficer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-09-30T15:43:25.000Z","updated_at":"2025-04-10T11:43:29.000Z","dependencies_parsed_at":"2023-01-23T10:00:58.195Z","dependency_job_id":"566ba1a1-40ce-4a7d-a3ef-dd7b200e81e5","html_url":"https://github.com/Rafficer/linux-cli-community","commit_stats":null,"previous_names":["protonvpn/linux-cli-community","protonvpn/protonvpn-cli-ng"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rafficer%2Flinux-cli-community","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rafficer%2Flinux-cli-community/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rafficer%2Flinux-cli-community/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rafficer%2Flinux-cli-community/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rafficer","download_url":"https://codeload.github.com/Rafficer/linux-cli-community/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250163645,"owners_count":21385278,"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":["linux","openvpn","protonvpn","protonvpn-cli","python","python3","vpn"],"created_at":"2024-08-02T01:03:30.450Z","updated_at":"2025-04-22T02:31:25.139Z","avatar_url":"https://github.com/Rafficer.png","language":"Python","readme":"\u003ch1 align=\"center\"\u003eProtonVPN-CLI\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/images/linux-cli-banner.png\" alt=\"Logo\"\u003e\u003c/img\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://pepy.tech/project/protonvpn-cli\"\u003e\u003cimg alt=\"Downloads\" src=\"https://pepy.tech/badge/protonvpn-cli\"\u003e\u003c/a\u003e\n    \u003cimg alt=\"GitHub\" src=\"https://img.shields.io/github/license/ProtonVPN/linux-cli\"\u003e\n    \u003ca href=\"https://pepy.tech/project/protonvpn-cli/week\"\u003e\u003cimg alt=\"Downloads per Week\" src=\"https://pepy.tech/badge/protonvpn-cli/week\"\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://twitter.com/ProtonVPN\"\u003e\u003cimg alt=\"Twitter Follow\" src=\"https://img.shields.io/twitter/follow/ProtonVPN?style=social\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.reddit.com/r/ProtonVPN\"\u003e\u003cimg alt=\"Subreddit subscribers\" src=\"https://img.shields.io/reddit/subreddit-subscribers/ProtonVPN?label=Join%20r%2FProtonVPN\u0026style=social\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003eA Linux CLI for ProtonVPN. Written in Python.\u003c/h3\u003e\n\nProtonVPN-CLI is a full rewrite of the [bash protonvpn-cli](https://github.com/ProtonVPN/protonvpn-cli/blob/master/protonvpn-cli.sh) in Python, which adds more features and functionality with the purpose of improving readability, speed and reliability.\n\n## Deprecation notice\nProton VPN is upgrading its OpenVPN infrastructure. This means the legacy OpenVPN configuration will stop working on 31 March 2025. After this date, you’ll need to switch to the [official Proton VPN for Linux app](https://protonvpn.com/support/linux-vpn-setup/), or reconfigure [OpenVPN](https://protonvpn.com/support/vpn-config-download/) or [WireGuard](https://protonvpn.com/support/wireguard-configurations/) manually.\n\n## Installation \u0026 Updating\n\nFor more detailed information on installing, updating and uninstalling, please view the extensive [usage guide](https://github.com/ProtonVPN/linux-cli-community/blob/master/USAGE.md#installation--updating).\n\n### Installing from distribution repositories\n\nFor the following Linux distribution(s), install the official `protonvpn-cli` package:\n\n#### Fedora\n\n```sh\nsudo dnf install -y protonvpn-cli\n```\n\n#### CentOS \u0026 RHEL\n\n`protonvpn-cli` is available for CentOS/RHEL 7.x and 8.x via the [EPEL repositories](https://fedoraproject.org/wiki/EPEL).\n\n**For CentOS/RHEL 7.x**:\n\n```sh\nsudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm\nsudo yum install protonvpn-cli\n```\n\n**For CentOS/RHEL 8.x**:\n\n```sh\nsudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm\nsudo dnf install -y protonvpn-cli\n```\n\n### Installing from PyPI\n\n#### Installing Dependencies\n\n**Dependencies:**\n\n- openvpn\n- dialog (optional, needed for interactive selection)\n- pip for python3 (pip3)\n- python3.5+\n- setuptools for python3 (python3-setuptools)\n\nDepending on your distribution, run the appropriate following command to install the necessary dependencies\n\n| **Distro**                              | **Command**                                                        |\n|:----------------------------------------|:------------------------------------------------                   |\n|Fedora/CentOS/RHEL                       | `sudo dnf install -y openvpn dialog python3-pip python3-setuptools`|\n|Ubuntu/Linux Mint/Debian and derivatives | `sudo apt install -y openvpn dialog python3-pip python3-setuptools`|\n|OpenSUSE/SLES                            | `sudo zypper in -y openvpn dialog python3-pip python3-setuptools`  |\n|Arch Linux/Manjaro                       | `sudo pacman -S openvpn dialog python-pip python-setuptools`       |\n\n#### Installing ProtonVPN-CLI\n\nInstallation happens via Python's package manager PIP.\n\n*Note: Make sure to run pip with sudo, so it installs globally and recognizes the command with sudo*\n\n`sudo pip3 install protonvpn-cli`\n\n#### Updating ProtonVPN-CLI\n\n`sudo pip3 install protonvpn-cli --upgrade`\n\n### Manual Installation from source\n\n*Disclaimer: If you are unsure about what you're doing, please follow the [normal installation guide](https://github.com/ProtonVPN/linux-cli-community/blob/master/USAGE.md#installation--updating).*\n\nIt is recommended to do the manual installation in a virtual environment. Especially if it serves the purpose of developing.\n\n1. Clone this repository\n\n    `git clone https://github.com/ProtonVPN/linux-cli-community`\n\n2. Step into the directory\n\n   `cd linux-cli`\n\n3. Install\n\n    `pip3 install -e .`\n\nFor updating, you just need to pull the latest version of the repository with git.\n\n### How to use\n\n#### For more detailed information, see the extensive [usage guide](https://github.com/ProtonVPN/linux-cli-community/blob/master/USAGE.md).\n\n| **Command**                       | **Description**                                       |\n|:----------------------------------|:------------------------------------------------------|\n|`protonvpn init`                   | Initialize ProtonVPN profile.                         |\n|`protonvpn connect, c`             | Select a ProtonVPN server and connect to it.          |\n|`protonvpn c [servername]`         | Connect to a specified server.                        |\n|`protonvpn c -r`                   | Connect to a random server.                           |\n|`protonvpn c -f`                   | Connect to the fastest server.                        |\n|`protonvpn c --p2p`                | Connect to the fastest P2P server.                    |\n|`protonvpn c --cc [countrycode]`   | Connect to the fastest server in a specified country. |\n|`protonvpn c --sc`                 | Connect to the fastest Secure Core server.            |\n|`protonvpn reconnect, r`           | Reconnect or connect to the last server used.         |\n|`protonvpn disconnect, d`          | Disconnect the current session.                       |\n|`protonvpn status, s`              | Print connection status.                              |\n|`protonvpn configure`              | Change CLI configuration.                             |\n|`protonvpn refresh`                | Refresh OpenVPN configuration and server data.        |\n|`protonvpn examples`               | Print example commands.                               |\n|`protonvpn --version`              | Display version.                                      |\n|`protonvpn --help`                 | Show help message.                                    |\n\nAll connect options can be used with the `-p` flag to explicitly specify which transmission protocol is used for that connection (either `udp` or `tcp`).\n\n## Contributing\n\nIf you want to contribute to this project, please read the [contribution guide](https://github.com/ProtonVPN/linux-cli-community/blob/master/CONTRIBUTING.md).\n","funding_links":[],"categories":["Python","Privacy/Security"],"sub_categories":["Other"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRafficer%2Flinux-cli-community","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRafficer%2Flinux-cli-community","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRafficer%2Flinux-cli-community/lists"}