Twirssi: a twitter script for irssi

Getting Started

Load the script in irssi: /script load twirssi.pl
Log in to twitter: /twitter_login username password. To use an account on identi.ca, just append @identica to the user name, and make sure Net::Identica is installed.
Post updates: /tweet I got twirssi working!
Every 5 minutes, new updates from twitter will be posted to the named window. To manually poll, you can always type /twitter_updates, though if you do it too often, twitter will block your access for a while

Posting Commands

/tweet <status> - Post a status update. Note, if http://twitter.com is too slow, twirssi will give up after the preset timeout. See the setting for twitter_timeout.
/tweet_as <account> <status> - Post a status update as an alternate account
/twitter_broadcast <status> - Post an update to all logged in accounts.
/dm <username> <message> - Send a direct message to username
/dm_as <account> <username> <message> - Send a direct message to username from the specified account
/twitter_reply <username>:<num> - Reply to a particular tweet. Only 100 are remembered for each user, and this can be completely disabled by changing the twirssi_track_replies variable.
/twitter_reply_as <account> <username>:<num> - Same as /twitter_reply but allowing specifying an account to reply from.
/reply <username>:<num> - Same as /twitter_reply, but only if the twirssi_use_reply_aliases is set to true (off by default).
/reply_as <account> <username>:<num> - Same as /twitter_reply_as, but only if the twirssi_use_reply_aliases is set to true (off by default).
/retweet <username>:<num> [comment] - Retweet someone else, with an optional comment. If no comment is provided, uses the native retweet command on twitter. If a comment is provided, a new tweet is posted.
/retweet_as <account> <username>:<num> [comment] - Retweet someone else, using an alternate account, with an optional comment.

Other Commands

/twitter_follow <username> - Start following username
/twitter_add_follow_extra <username> - Show all the posts by username, even for people who you do not follow
/twitter_del_follow_extra <username> - Stop showing all the posts by username
/twitter_list_follow_extra - Show the list of all the usernames in the extra follow loop
/twitter_list_subscriptions - List all the existing search subscriptions for all accounts.
/twitter_login <username> <password> - Log in to twitter
/twitter_logout [<username>] - Log out the current account, or the named account
/twitter_switch <username> - Start using the named account as the default
/twitter_unfollow <username> - Stop following username
/twitter_block <username> - Block username
/twitter_unblock <username> - Unblock username
/twitter_updates - Poll for updates manually
/twitter_spam <username> - Report a username for spamming.
/twitter_subscribe <keyword> - Add a search subscription for the current account.
/twitter_unsubscribe <keyword> - Remove an existing search subscription from the current account.
/twitter_device_updates <none|im|sms> - Set delivery device. Note that IM delivery is currently disabled by Twitter, and there are no timeline when it might be restored.
/twirssi_version - Report the current version number
/twirssi_upgrade - Check for a new version of twirssi, and download it if it's there
twitter_delete <username[:num]> - delete a status update. Without a :num, delete the last status posted.

Settings

These are set by the /set command - /set bitlbee_server will show the current value, /set bitlbee_server bitlbee_tag will set it to bitlbee_tag.

bitlbee_server - What is the server tag for bitlbee (used for away messages)
short_url_provider - What service to use to shorten urls - pick from WWW::Shorten
short_url_args - Some of the WWW::Shorten modules require additional arguments, such as a username or API key. Enter those here if needed, comma separated.
twirssi_always_shorten - When false (the default), URLs will only be shortened if the tweet would be too long. When true, URLs will always be shortened
show_own_tweets - Should our own tweets be displayed? Defaults to on.
show_reply_context - When set to on, and someone you follow is replying to someone you are not, the tweet that generated the reply will be pulled and shown. Defaults to off.
tweet_to_away - Set to on to post non-@reply updates as your away message
tweet_window_input - Enable tweeting directly by writing to the twitter window. Off by default
twirssi_retweet_format - The format to use when retweeting. Default value is "RT $n: "$t" ${-- $c$}". $n is the nick that's being retweeted; $t is the text of the original tweet; $c is the text of the optional comment attached; ${ and $} mark the seciton that should be omitted if no comment was provided.
twirssi_ignored_accounts - Comma separated list of accounts that aren't polled for new tweets.
twirssi_ignored_tags - Comma separated list of tags that will hide any tweet containing them.
twirssi_stripped_tags - Comma separated list of tags that will be removed before a tweet is displayed.
twirssi_hilights - Should messages containing your @nick be considered IRC hilights. (default on)
twirssi_location - Location of the twirssi.pl script, used by /twirssi_upgrade
twirssi_nick_color - If set, @nicks will be shown in the color set. (default: %B). Note that the theme variables (twirssi_tweet, twirssi_search, twirssi_reply, twirssi_dm) should be updated as well.
twirssi_notify_timeouts - If set, twirssi will emite a message when twitter is being so slow that it fails to retrieve updates. (default on)
twirssi_replies_autonick - On by default. If on, /reply will make sure the reply begins with @nick. If off, you can reply to someone, but not have their name on the reply
twirssi_replies_store - Location where the /reply map is to be stored.
twirssi_topic_color - If set, #topics will be shown in the color set. (default: %r)
twirssi_track_replies - Should twirssi keep track of individual IDs of incoming twitters? If enabled (which is the default) incoming tweets will show a :num appended to them. This is requried for /reply and /twitter_reply functionallity.
twirssi_use_reply_aliases - Enable /reply and /reply_as as aliases to /twitter_reply and /twitter_reply_as. Requires a reload of twirssi to take effect. (default off)
twirssi_upgrade_beta - Default off. If on, /twirssi_upgrade will try to grab the most recent version from github, instead of the latest released version. Note that beta versions might have more bugs than the released version.
twirssi_avoid_ssl - Default off. If off, twirssi will attempt to use SSL for all network communications. Changes take effect next time twirssi is loaded.
twitter_passwords - A comma separated list of passwords to auto-login
twitter_poll_interval - How often should new messages be requested from twitter (in seconds). Default is every 5 minutes. Keep in mind that twitter will rate limit your user (or IP) if you hit them too often. Hardcoded minimum is one minute.
twitter_friends_poll - How often should the updated friends list be retrieved from the server. By default, only once every 10 minutes
twitter_timeout - How long should we wait before giving up on a twitter operation. Should help avoid irssi pinging out of IRC servers when twitter is slow.
twitter_usernames - A comma separated list of usernames to auto-login. Note that the last one will be the default account used after startup.
twitter_window - Which irssi window should twitter updates be sent to