Icon Animation

Tunnelblick displays the VPN connection status using the Tunnelblick icon in the Status Bar. The Tunnelblick icon is usually located next to the Spotlight icon, but if the "placeIconInStandardPositionInStatusBar" preference is set, the icon will be placed to the left of the icons being displayed at the time Tunnelblick is launched.

• The Tunnelblick icon indicates a closed tunnel (i.e., no VPN connection) with a "dark" tunnel:

• An open tunnel (i.e., a VPN connection) is indicated with a "light" tunnel:

• When a tunnel (VPN connection) is in the process of being established or taken down, the icon is animated, going from "dark" to "light" and back repeatedly.

Icon Sets

A folder containing a set of these images meant to be used together is called an "icon set".

Tunnelblick comes with one folder containing the standard icon set built-in. It is located within the Tunnelblick application itself, at

Tunnelblick.app/Contents/Resources/IconSets/TunnelBlick.TBMenuIcons.

When Tunnelblick is launched, it looks for an icon set to use in three places, in the following order:

1. Tunnelblick.app/Contents/Resources/Deploy/IconSets/TunnelBlick.TBMenuIcons;
2. /Library/Application Support/Tunnelblick/Shared/IconSets/TunnelBlick.TBMenuIcons; and
3. Tunnelblick.app/Contents/Resources/IconSets/TunnelBlick.TBMenuIcons.

Note: The "menuIconSet" preference, if present, specifies the name of the folder (within the "IconSets" folder) that contains the icon set to be used. If not present, this defaults to "TunnelBlick.TBMenuIcons".

Custom Icon Sets

Custom icon sets can be used to override the standard icon set.

First, create a folder named "TunnelBlick.TBMenuIcons" containing the images. The images must be named:

• "open.png": this is the icon used to indicate an open tunnel (a VPN connection is active)
• "closed.png": this is the icon used to indicate a closed tunnel (no VPN connection is active)
• "1.png", "2.png", "3.png", etc.: these icons are used in sequence to indicate a transition from open to closed or closed to open.

Next, either

1. Replace the Tunnelblick.app/Contents/Resources/IconSets/TunnelBlick.TBMenuIcons folder with your folder; or
2. Create an "IconSets" folder, place your folder inside it, and place it in either
• Tunnelblick.app/Contents/Resources/Deploy; or
• /Library/Application Support/Tunnelblick/Shared.

What happens to your icon set when Tunnelblick is updated depends on where you put it:

• If it is in Tunnelblick.app/Contents/Resources/IconSets, it will be replaced with the standard icon set;
• If it is in Tunnelblick.app/Contents/Resources/Deploy, it will be restored after Tunnelblick is updated;
• If it is placed in /Library/Application Support/Tunnelblick/Shared, it will not be affected when Tunnelblick is updated.

PLEASE USE THE TUNNELBLICK DISCUSSION GROUP FOR COMMENTS OR QUESTIONS