ZSH shell scripts to manage Tunnelblick VPN sessions from your SHELL

---

Few lines describing your project.

📝 Table of Contents

• About
• Getting Started
• Deployment
• Usage
• Built with
• TODO
• Contributing
• Authors
• Acknowledgments

🧐 About

The last few years I've been running tunnelblick to connect certain customer and business OpenVPN servers. One of the more annoying things for me was the inability to control Tunnelblick sessions from the command line. Especially when you - like me - are working on several projects in a day and the customer requests to perform a quick change on their environment.

These shell scripts were created to be used with zsh to trigger the Applescript interface provided by tunnelblick.

🏁 Getting Started

These instructions will get you a copy of the project up and running on your MacOS Ventura.

Prerequisites

What things you need to install the software and how to install them.

• MacOS Ventura
• a terminal client like iTerm2
• Tunnelblick

Installing

the Easy route

zsh <(curl -s https://raw.githubusercontent.com/gmkey/tunnelblick_cli_macos/master/install_vpnconnect_shell_integration.zsh)

manually

A step by step series of examples that tell you how to get a development env running.

Say what the step will be

Give the example

And repeat

until finished

End with an example of getting some data out of the system or using it for a little demo.

🎈 Usage

integrated into your zsh environment.

The script has 4 parameters: config, open, close and clear

config

vpnconnect config

will prompt you to configure your preferred OpenVPN configuration in Tunnelblick. If you don't give one it will list the configurations to choose from.

clear

vpnconnect clear

clears your configuration

open

vpnconnect open

Will disconnect any running VPN sessions and connect your VPN configuration you configured as default.

vpnconnect open <another_VPN_configuration>

Will disconnect any running VPN sessions and connect to the given VPN configuration.

close

vpnconnect close

Will close the session you opened and will reconnect to the previous VPN connection. (Ideal for short logins to external environments).

⛏️ Built with

• Tunnelblick - OpenVPN client for MacOS
• zsh - Zsh is a shell designed for interactive use, although it is also a powerful scripting language.

✍️ Authors

• @gmkey - Idea & Initial work

See also the list of contributors who participated in this project.

🎉 Acknowledgements

• Hat tip to anyone whose code was used
• Inspiration
• References