Awesome
tunblkctl
<img src="https://github.com/azhuchkov/tunblkctl/assets/765471/25bf7e5a-e53b-4c8d-b99f-e96da1dae6bc" alt="logo" align="right"/>
A streamlined command-line frontend for Tunnelblick, designed to automate VPN-related workflows. Perfect for integrating VPN management into command-line driven tasks.
<br clear="right"/>Highlights
- Lightweight: Under 15KB uncompressed.
- Tab-Completion: Includes scripts for ZSH, Bash and Fish.
- Rapid Installation: Quick setup with Homebrew.
- Zero Dependencies: Only macOS and Tunnelblick are required.
- Configurable: Tailor output using environment variables and switches.
- Well-Documented: Complete user manual.
- Open License: Freedom with MIT license.
Usage
tunblkctl
is very easy to use. Thanks to tab-completion and aliases,
tunblkctl
is even simpler and more convenient.
$ tunblkctl ls
cloudvpn workvpn
$ tunblkctl connect --wait cloudvpn
$ tunblkctl status
VPN IN OUT AUTO
cloudvpn 4.91M 888.84K -
workvpn 6.35K 4.76K -
$ tunblkctl disconnect
Find more commands and options in the full manual.
Installing
The easiest way to install the tool is using Homebrew:
$ brew install azhuchkov/tools/tunblkctl
Or to install the latest (unstable) version:
$ brew install --HEAD azhuchkov/tools/tunblkctl
FAQ
Q: I installed the software using the recommended method, but tab-completion doesn't work. Why?
A: Try using a new shell session by opening a new terminal tab or window.
Q: My shell session is restarted, but tab-completion still isn't working. What should I do?
A: Ensure that your shell is on the list of supported shells and is properly configured.
License
tunblkctl
is licensed under the terms of the MIT License.
See LICENSE
for more information.