Skip to content

azhuchkov/tunblkctl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tunblkctl

logo

GitHub release (with filter) GitHub commits since latest release (by SemVer including pre-releases) GitHub Workflow Status (with event) GitHub code size in bytes GitHub License GitHub Repo stars

A streamlined command-line frontend for Tunnelblick, designed to automate VPN-related workflows. Perfect for integrating VPN management into command-line driven tasks.


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.