Purpose:

• Allows mass invisible messages by reposting a direct message to it to all those following it. (This is invisible as long as the bot itself is ‘protected’, which it is.)
• Effectively creates a ‘group’ within Twitter.

Usage:

• Follow @spsp
• Direct message your message to spsp with the regular syntax. i.e. “d spsp @zethraeus I am testing your excuse-for-a bot”.
• The message will be reposed as a regular tweet by the bot, without the initial ‘d sps’, but with your twitter alias signed at the end. i.e. the above message would be posted as “@zethraeus I am testing your excuse-for-a bot ~ @alias”.

Limitations:

• The bot can not handle accented characters. It will cut off your message from the point the accented character is introduced. This is the case because of a quirk in php’s libxml2 functionality – and because I am not a particularly good or dedicated PHP programmer. This quirk is not a bug (apparently).
• Should your message be above 140 characters once the ‘d spsp’ is removed and your alias is appended, it will be shortened in Twitter, and any clients like Twitterrific. It will require a click through to see the unabridged version. Whilst this isn’t a huge issue, it’s probably worth keeping the tweets a little bit shorter.
• In theory, if the modified tweet exceeds 160 characters, it may not send. In reality, Twitter wont let you have a name long enough to make this occur in normal usage.
• The tweets are passed on every five minutes. (This is a cron job)
• The maximum processable tweets at each 5 minute slot are 20. I don’t know enough about the workings of http://twitter.com/direct_messages.xml to say whether any tweets exceeding the 20 will be lost into Twitter or just processed 5 minutes later.

The script is comprised of three files.

1. process.php grabs all of @spsp’s direct messages since the last recorded id, records the new last id and reposts the direct messages as tweets.
2. twitter.php, found at http://www.aimclear.com/code/twitter/twitter.txt is a modified version of the twitter api. It is responsible for actually posting the status.
3. lastid.txt is simply used to record the id of last read direct message so that tweets aren’t posted twice.

All of these files are available for download and the bits that are mine, are in the public domain for you to do what you want with.

I just hope that people use it!