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.
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.
Make sure you have a recent version of Python and PyGTK installed.
Run the awesum.py Python script from the directory you unpacked the Awesum distribution to in step 2.
This may be achieved in two ways. Firstly, awesum.py 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 awesum.py
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 awesum.py. If you are writing a shell script, be sure to run the awesum.py Python script from the same directory as the awesum.glade 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:
#!/bin/sh # Save this script as /usr/bin/awesum and make it executable. (cd LOCATION_OF_AWESUM; python awesum.py)
As of Awesum 0.6.0, installation (install.sh) and uninstallation (clean.sh) 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.