Hrafn is a python twitter application. It started because no existing client supported the Lists API, but has grown to be a general-purpose Twitter client.

Installation

You'll need the following python modules:

• pyGTK
• dateutil
• twitter (the dev version, not 0.6), along with my patches (included here)

For the twitter module, you can download and install it with:

hg clone https://python-twitter.googlecode.com/hg/ python-twitter
cd python-twitter
hg update dev
for i in ../hrafn/python-twitter-*.patch; do patch p1 < $i; done
python setup.py build
python setup.py install --user

This will install python-twitter in your ~/.local/lib directory, which python 2.6 will automatically include in PYTHONPATH.

Configuration

Copy the supplied hrafn.conf file to ~/.hrafn.conf, and edit it to suit your preferences. At a minimum, you need to change the [account] section to contain a valid twitter username and password. You can have multiple [account] sections, but they must be uniquely named, and the section name must start with 'account'.

Usage

Just run ./hrafn.py, and start playing around. Right now, it is best to run this file in-place; it expects twitterwidgets.py and default.glade to be in the same directory.