hrafn/README

mytwitter is a simple python twitter application.  I wrote it for two reasons:

1. No existing twitter app supports the Lists API

2. An excuse to learn Python


While I doubt it will be terribly useful for anyone other than me, feel free to take it for a spin and let me know how it goes.


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



USAGE
-----
Just run ./mytwitter.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.