A twitter client for Linux
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
Anna f16404889d Just touching some files 10 years ago
patches Just touching some files 10 years ago
ui Initial widgets in place for adding an account management window 10 years ago
README.markdown Added a default avatar image for users without one 10 years ago
TODO Updated docs to reflect fixed bug 10 years ago
apithreads.py Fixed printing lists for users 10 years ago
config.py More cleanup from the refactor 10 years ago
hrafn.conf Just touching some files 10 years ago
hrafn.py Don't show retweet in DM pane, DM pane 'Reply' button should send DM to target user, and position cursor / dehilight text when replying 10 years ago
oauthtwitter.py Just touching some files 10 years ago
twitterwidgets.py Fixed a bug where a string with multiple &'s wasn't getting escaped correctly... zero-width lookaheads to the rescue\! 10 years ago
usercache.py Added a default avatar image for users without one 10 years ago


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.


You'll need the following python modules:

  • pyGTK
  • dateutil
  • python-oauth
  • python-twitter (the dev branch), 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.


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.


The system tray icon is Public Domain from http://commons.wikimedia.org/wiki/File:Capi_x_Raven.svg The question mark icon is Public Domain from http://commons.wikimedia.org/wiki/File:Question_mark.svg