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
• /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.
• /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_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

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_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