Vidalia is a cross-platform graphical controller for the Tor software, built using the Qt framework. Vidalia runs on most platforms supported by Qt 4.3 or later, including Microsoft Windows, Apple OS X, and Linux or other Unix variants using the X11 window system. It was originally written by Matt Edman, and is currently maintained by Tomás Touceda.
Vidalia lets you start and stop Tor, see how much bandwidth you are consuming, see how many circuits you currently have active, see where these circuits are connected on a global map, view messages from Tor about its progress and current state, and let you configure your Tor client, bridge, or relay with a simple interface. Included in Vidalia is an extensive help system which helps you understand all of the options available to you. All of these features are translated into a large number of languages.
You should simply download Vidalia as part of a Tor software bundle. Users should be using Tor Browser Bundle, not installing Vidalia themselves.
The most recent stable release is 0.2.21, and the most recent alpha release is 0.3.1.
- Instructions for Debian/Ubuntu/Knoppix Repositories
- Stable Source Tarball (sig)
- Alpha Source Tarball (sig )
Vidalia is always looking for volunteers that want to help in development. To start you should first take a look at the volunteer page and see if there is something that interests you the most. Vidalia's source code lives now in a Git repository. The clone URL is git://git.torproject.org/vidalia. You should get to know how Vidalia works internally in order to work with it. To do this you should know C++ and Qt.
If you intend to start coding already, please read and follow the HACKING guide. If you have a patch for a feature or a bug fix, first check the tickets that are already submitted, if there isn't a suited one for your patch, you can submit a new ticket selecting Vidalia as its Component.
If you found a bug or you want a specific feature for future Vidalia releases, please file a new ticket selecting Vidalia as its Component.
Most Tor project members use IRC to communicate. You can find Tomás in the #vidalia channel at OFTC under the nick chiiph. Please get in touch in order to see what everyone's working on, and to share what you've been working on or what you want to do. If you intend to join the team, it's expected that you stay around IRC, either in Vidalia's channel, or #tor-dev.
If you have any doubts about any of the points in here, you can contact us about it.