Getting Started
- Load the script in irssi:
/script load twirssi.pl
- Log in to twitter:
/twitter_login username password
- 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
/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_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_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
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.
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_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