hrafn/README.markdown

Huginn 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 ../huginn/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 huginn.conf file to ~/.huginn.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 ./huginn.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.