For other flavors of Linux and UNIX-like systems

  1. Download the tarball distribution of Awesum. It will be a file of the form awesum-x.y.z-src.tar.gz, where x.y.z is the version number.

  2. Unpack the tarball distribution. One of the following commands should be sufficient:

    $ tar zxvf awesum-x.y.z-src.tar.gz


    $ gunzip -c awesum.tar.gz | tar xvf -


    The '$' symbol in the command lines above is a typical UNIX command prompt and should not be typed as part of the commands. Also, be sure to replace the x.y.z portion of the file name with the actual version number for Awesum.

  3. Make sure you have a recent version of Python and PyGTK installed.

  4. Run the Python script from the directory you unpacked the Awesum distribution to in step 2.

    This may be achieved in two ways. Firstly, is an executable shell script, meaning that you may run it directly using the following command:

    $ ./

    The second method is to invoke the Python interpreter like so:

    $ python

As an optional final step, you may wish to integrate Awesum into your system by creating a symbolic link or a shell script pointing to the location of If you are writing a shell script, be sure to run the Python script from the same directory as the file that is part of the distribution.

To create a symbolic link for convenient execution of Awesum, use a command similar to the following:

$ ln -s LOCATION_OF_AWESUM /usr/bin/awesum

As an alternative, one could write a shell script similar to the following:

# Save this script as /usr/bin/awesum and make it executable.


As of Awesum 0.6.0, installation ( and uninstallation ( shell scripts are included as part of the distribution. Be careful with these though. They have only been tested on Fedora Core 1, so they may blow up your system or something. If you are the cautious type, it is recommended that you manually integrate Awesum into your system or use the RPM distribution.