https://github.com/azhuchkov/tunblkctl

Command-line frontend for Tunnelblick
https://github.com/azhuchkov/tunblkctl

bash-completion cli macos openvpn tunnel tunnelblick vpn zsh-completion

Last synced: 16 days ago
JSON representation

Command-line frontend for Tunnelblick

• Host: GitHub
• URL: https://github.com/azhuchkov/tunblkctl
• Owner: azhuchkov
• License: mit
• Created: 2023-11-10T14:16:39.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-09-11T13:26:50.000Z (3 months ago)
• Last Synced: 2025-09-11T16:25:48.470Z (3 months ago)
• Topics: bash-completion, cli, macos, openvpn, tunnel, tunnelblick, vpn, zsh-completion
• Language: Shell
• Homepage:
• Size: 66.4 KB
• Stars: 34
• Watchers: 1
• Forks: 2
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-cli-apps-in-a-csv - tunblkctl - Command-line frontend for Tunnelblick. (<a name="networking"></a>Networking)
• awesome-cli-apps - tunblkctl - Command-line frontend for Tunnelblick. (<a name="networking"></a>Networking)

README

          
# tunblkctl



![GitHub release (with filter)](https://img.shields.io/github/v/release/azhuchkov/tunblkctl)

![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/azhuchkov/tunblkctl/latest)

![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/azhuchkov/tunblkctl/makefile.yml)

![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/azhuchkov/tunblkctl)

![GitHub License](https://img.shields.io/github/license/azhuchkov/tunblkctl)

![GitHub Repo stars](https://img.shields.io/github/stars/azhuchkov/tunblkctl?style=flat)

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](#installation) with Homebrew.

- **Zero Dependencies**: Only macOS and Tunnelblick are required.

- **Configurable**: Tailor output using environment variables and switches.

- **Well-Documented**: Complete [user manual][man].

- **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. 

```console

$ 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][man].

## Installation

The easiest way to install the tool is using [Homebrew]'s [formula]:

`$ 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](https://docs.brew.sh/Shell-Completion). 

## License

`tunblkctl` is licensed under the terms of the MIT License.

See [LICENSE](https://github.com/azhuchkov/tunblkctl/blob/main/LICENSE)

for more information.

[man]: https://github.com/azhuchkov/tunblkctl/wiki/User-Manual

[Tunnelblick]: https://tunnelblick.net

[Homebrew]: https://brew.sh/

[formula]: https://github.com/azhuchkov/homebrew-tools/blob/main/Formula/tunblkctl.rb