1.6 KiB
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
- python-oauth
- python-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/patches/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.
Usage
Just run ./hrafn.py, and start playing around. Right now, it is best to run this file in-place; it expects all the .py files and default.glade to be in the same directory.
To register an account with hrafn, simply click File -> Add Account. An authorization screen will launch in your web browser. When you finish there, you should have a PIN. Copy this into the popup that hrafn created, and click 'ok'.
To search for a user, prepend the search with 'user: '.
After the first run, the program will write a file called ~/.hrafn.conf, with default configuration. Feel free to edit this file if needed.
If things get really mucked up, deleting ~/.hrafn.db will reset the application to a pristine state. You will have to re-authenticate, though.
Notes
The system tray icon is Public Domain from: http://commons.wikimedia.org/wiki/File:Capi_x_Raven.svg
