README

twitterlost is a command-line tool to keep track of your Twitter
followers. Each time it runs it shows you the new and lost followers
since the last time it ran.

Description
-----------

Keep track of your twitter followers, see who has unfollowed
you. Sadly it will not tell you why (but it was probably because of
something you did).

Installation
------------

1. Install the gem.

2. mkdir ~/.twitterlost (or run twitterlost once and it will be
   created for you)

3. Edit ~/.twitterlost/twitter.yml with the following information:

---
:login: $USERNAME
:password: $PASSWORD

That's it. The first time you run twitterlost it will see all your
followers as new; after that it will only report changes.

License
-------

Twitterlost is released under the MIT license. Take it, play with it,
do whatever you want with it, keep this version free.

Motivation
----------

Why did I write Twitterlost? Because I think Twitterless.com is a good
service wrapped around a brilliant idea, but I didn't want to give
them my Twitter login and password. If you don't see a problem with
giving them your login credentials, then by all means use their
service; it's better than this hack. They'll send you regular email
updates and such, where twitterlost has to be run by hand.

Known Issues
------------

twitterlost uses the Twitter API to retrieve your list of
friends. This is returned in chunks of 100. If you have more than 100
followers, twitterlost must make multiple calls to Twitter. EACH CALL
counts towards Twitter's 70-calls-per-hour limit. If you have many
followers and are running a polling Twitter client, Twitter may slap
you withan "overloaded" message. If this happens to twitterlost, it
interprets this as the end of your friends list, which means it will
report all those people as lost friends. They'll come back the next
time you run twitterlost.