Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sttz/expresso
expresso is a command line interface to control the ExpressVPN app
https://github.com/sttz/expresso
Last synced: 3 days ago
JSON representation
expresso is a command line interface to control the ExpressVPN app
- Host: GitHub
- URL: https://github.com/sttz/expresso
- Owner: sttz
- License: mit
- Created: 2020-04-12T16:34:09.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T14:57:19.000Z (almost 2 years ago)
- Last Synced: 2024-08-02T20:45:42.200Z (3 months ago)
- Language: C#
- Size: 879 KB
- Stars: 62
- Watchers: 5
- Forks: 11
- Open Issues: 11
-
Metadata Files:
- Readme: Readme.md
- Changelog: Changelog.md
- License: LICENSE
Awesome Lists containing this project
- awesome - sttz/expresso - expresso is a command line interface to control the ExpressVPN app (C# #)
README
# Expresso CLI for ExpressVPN
expresso is a command line interface to control the ExpressVPN app. It uses the same native messaging interface as the open-source ExpressVPN browser extension.
# Setup
[Download the latest release here](https://github.com/sttz/expresso/releases). expresso is a self-contained executable and has no dependencies.
Or you can install via [Homebrew](https://brew.sh/) using [sttz/homebrew-tap](https://github.com/sttz/homebrew-tap), see the tap readme for instructions.
# Alfred Workflow
expresso also comes with an [Alfred](http://alfredapp.com) workflow, which enables to easily choose locations, connect and disconnect from Alfred.
[Download the workflow here](https://github.com/sttz/expresso/releases). The workflow bundles expresso, so you don't need to install anything else.
**Legend**
* ⚡️Connected location
* ❤️Location favorited in the ExpressVPN app
* 🕙Recent location
* 👍Recommended «Smart Location»
# Usage
```
expresso v1.3.0
USAGE: expresso [--help] [--version] [--verbose...] [--quiet] [--timeout ]
GLOBAL OPTIONS:
-h, --help Show this help
--version Print the version of this program
-v, --verbose Increase verbosity of output, can be repeated
-q, --quiet Only output necessary information and errors
-t, --timeout Override the default connect/disconnect timeout (in
milliseconds)
---- LOCATIONS:
List all available VPN locations
USAGE: expresso [options] locations
---- STATUS:
Show the current VPN connection status
USAGE: expresso [options] status
---- CONNECT:
Connect to a VPN location
USAGE: expresso [options] connect [--change] [--random] [--toggle] []
OPTIONS:
-c, --change Change current location when already connected
--random Choose a random location in the given country
--toggle Disconnect instead when already connected (to the given
location with --change)
Location to connect to, either location id, country or
keyword
---- DISCONNECT:
Disconnect from the current VPN location
USAGE: expresso [options] disconnect
---- ALFRED:
Output the main options for the Alfred workflow
USAGE: expresso [options] alfred [--locations]
OPTIONS:
--locations Output the locations for the Alfred workflow
---- REPL:
Interactively communicate with the helper
USAGE: expresso [options] repl
```