Installation on Mac OS

Install Git

Verbose Guacamole currently requires you to have Git installed to use the version control features.

Unfortunately, Windows does not come with Git. If you'd like to test for it anyway, run git --version in the "Terminal" app, which should output your current version of Git if it is present.

If Git is not installed, install it from the official website.

For easiest installation, we recommend using the install it from the official website.

To confirm, you can run git config --list, which should output the values you set above.

Direct .dmg File

First, find the most recent version on the Github Releases page. Don't pick a version that's title includes "Beta" or "RC", those are preview releases and not intended for normal use.

Open the accordion labelled "Assets" at the bottom of the release. Download the file that ends in ".dmg".

You should be able to open the file normally. You will be presented two icons, a file labelled "Verbose Guacamole" and a folder labelled "Applications". Drag the file icon onto the folder icon, and it will add VerbGuac to your applications.

Direct .zip File

Alternatively, we provide a portable version of Verbose Guacamole. To use it, download the file including "darwin" (Mac OS's codename) and ".zip" instead of the ".dmg" file.

Unzip this wherever you would like to store Verbose Guacamole. To run the program, open the file named "Verbose Guacamole".

Note: This has not been tested, but you could probably drag the file named "Verbose Guacamole" into your applications folder and the program will be able to be launched normally.


To upgrade your version, follow the exact same steps and the new version should replace your old version. Make sure to close any running windows from Verbose Guacamole first!

In the Future

We are working on a system to automatically notify you when new updates are available. Until then, just check the home page of the app every now and then, which lists releases along with what your current release is.

These instructions are for installing on Mac OS.Get instructions for a different operating system.