[Back to the Floodgap main page] Return to Floodgap Software

TTYtter for Perl (Legacy 0.8.6)

Hey, you should probably read this. Yeah, you.

This is version 0.8.6 (15 December 2008), the final version of the long-lived 0.8 branch. There will be no further bug-fixes to this branch and is provided for those who can't or prefer not to use the current version.

If you came here by mistake and want the current version, go back to the main page.

*** Subscribe to updates over Twitter! -- twitter.com/ttytter


Noooo, not another Twitter client! Yes, another Twitter client. The difference here is that you're dealing with a multi-functional, fully 100% text, Perl command line client.

ttytter requires Perl 5.005 or better, and either cURL or Lynx (chosen on purpose since more people are likely to have one or both of those instead of LWP, and also to allow people to carry over their proxy settings and whatnot). Nothing else is necessary; it does not use Net::Twitter and does not require it. It will work fine over any dummy terminal, serial connection or telnet/ssh login. ttytter is offered as freeware under the Floodgap Free Software License. The download link is at the bottom of the page you're reading now; please read through it completely before downloading.

Note to identi.ca users: According to this wiki entry, laconi.ca and identi.ca users can use Twitter-compatible API clients to access those services. I don't use either one of these, so I can't say -- your experiences would be appreciated. Note that some services may not support direct messaging, so you may need to turn that off (-dmpause=0 will accomplish this; see the options below).

Using TTYtter as an interactive client

To use ttytter as a regular interactive client, chmod +x and run from the command line. If your Perl is not in /usr/bin, change the first line (/usr/bin/env on some systems does not support passing arguments in shebang lines, so for maximum compatibility it is not used here). You will need to specify your username and password with the -user option, like so:

% ./ttytter -user=screwtape:wormwood

(NB: If you have a password like pa$$word that has shell metacharacters in it, try a command string like ./ttytter '-user=screwtape:pa\$\$word' [note single quotes around the entire option and backslashes before the metacharacters].) Yes, you can put the password in an external file; more about that when we get to .ttytterrc.

ttytter will try to detect which client you have (it prefers cURL but you can force Lynx with -lynx), and then starts up if it can run a test query successfully. It then starts a background process that every 120 seconds (customizable) will get new tweets and, at less frequent intervals, direct messages. When it comes up, it looks something like this:

trying to find curl ... /usr/bin/curl
test-login SUCCEEDED!

######################################################        +oo=========oo+ 
         TTYtter 0.8.6 (c)2008 cameron kaiser                 @             @
                 all rights reserved.                         +oo=   =====oo+
       http://www.floodgap.com/software/ttytter/            a==:  ooo
                                                            .++o++. ..o**O
  freeware under the floodgap free software license.        +++   :O:::::
        http://www.floodgap.com/software/ffsl/              +**O++ #   :ooa
                                                                   #+$$AB=.
         tweet me: http://twitter.com/ttytter                      #;;ooo;;
            tell me: ckaiser@floodgap.com                          #+a;+++;O
######################################################           ,$B.*o*** O$,
#                                                                a=o$*O*O*$o=a
# when ready, hit RETURN/ENTER for a prompt.                        @$$$$$@
# type /help for commands or /quit to quit.                         @o@o@o@
# starting background monitoring process.                           @=@ @=@
TTYtter> <barely> Looks like I am going to Baltimore next week
<pamela> Redesign for bookstore website is almost done! RFP for custom publishing projects in the works due to start in Sept. Keeping busy.
-- checking for most recent direct messages:
[DM cbqueue/Fri Sep 28 02:01:33 +0000 2007] test test
[DM ttytter/Fri Sep 28 03:01:51 +0000 2007] don't forget to update the website

You can tunnel your traffic under SSL if your Lynx or cURL supports it, but make sure you read the rest of this page before reading about TTYtter and SSL.

If you specify any arguments on the command line (like ttytter foo), then foo is seen as a filename to read tweets and commands from instead of standard input. A fatal error will occur if foo doesn't exist. We'll talk about scripting TTYtter in a moment, but first let's talk about ...

Basic tweeting

By and large, most people use TTYtter as an interactive client. In this mode, it acts much like a command line IRC or micq. Like such clients, unless you specify otherwise, updates occur automatically and without any intervention from you, although you can request an update early (see Built-in commands).

To send a tweet, just type it. It will be submitted and appear on the next update. Keep in mind that posting tweets and executing most commands are asynchronous operations, so don't expect instant feedback.

If an update occurs and your tweet is overwritten on screen, don't worry: just hit CTRL-R, and the line you're currently working on will be redisplayed.

If your tweet is over 140 characters, it will be automatically trimmed (hopefully intelligently to a word or punctuation boundary) and you will be offered a chance to accept or edit the trimmed version. This affects the re-tweet command history (q.v.).

If your terminal supports ANSI colour sequences (or you force it on with -ansi), then replies to you appear in red, and your own tweets appear in yellow.

If ttytter can't download any tweets or messages, or if the Obvious folks have put up an announcement or service outage page, ttytter will report the error and retry automatically when it can. If your terminal supports ANSI colour sequences (or you force it on with -ansi), then server messages appear in purple.

Built-in commands

Speaking of commands, there are also some ttytter internal commands you can use. All internal commands start with /. Starting with 0.6, if you enter a bogus command, ttytter will complain at you instead of tweeting it, which should cut down on mildly useless but enormously entertaining tweets like /quot and /refrehs. If you really want to send a tweet that starts with a slash, just double slash it (e.g., //the ants are my friends/they're blowing in the wind/) and the double slash will be made a single slash and passed on.

Starting with 0.6, most commands have a quick abbreviation, which is given in parentheses. Most commands are asynchronous, meaning that you can do stuff in the foreground while the background process does the work, but some are synchronous and will hold your console temporarily for technical reasons.

/help (/?)
Displays mad-k001 ASCII art. Oh, and a quick list of commands, secondarily speaking.
/refresh (/r)
Thumps the background process to do another update for new tweets right away instead of waiting for the next one scheduled. Remember, Twitter only gives us the last twenty tweets, so you will therefore only get the last twenty too (important if you're watching the public timeline, or have a lot of friends). If nothing new is available, the background process will politely tell you so. (/thump is a synonym since I keep typing it.)
/again (/a)
Displays the last twenty tweets, even old ones.
/again [username] (/a [username])
Displays the last twenty tweets for user username (sans braces, of course). If the user doesn't exist, or is protected/otherwise not available to you, you will get an error message instead. This command is synchronous and the foreground process will pause until the tweets are received or timed out.
/whois [username] (/w [username])
Displays the Twitter "vital statistics" for the specified user, including number of people they follow and are followed by (f:), number of updates (u:), real name, location, description, URL and image/picture, along with (if you are not anonymous) if you already follow this user and if this user follows you.

If you specify a filter with -avatar (below), then the URL for the user's picture is passed to the specified shell command to operate upon it, including saving it, opening it in a window somewhere else, or even converting it to ASCII art. This command is synchronous and the foreground process will pause until the data is received or timed out.

/wagain [username] (/wa [username])
Combines /again followed by /whois (yes, the name is out of order, but it sounded better than /againw).
/dmrefresh (/dm)
Thumps the background process to do another check for direct messages right away instead of waiting for the next one scheduled. Again, this is limited to the last twenty, if you are a particularly popular person to whisper to. See the section on direct messaging below.
/dmagain (/dma)
/again:/refresh::/dmagain:/dmrefresh
/replies (/re)
Displays your last twenty @ replies. This may be affected by your Twitter account notifications settings. This command is synchronous and the foreground process will pause until the replies are received or timed out.
/history (/h)
Displays the last set of commands entered (see Command history below).
/me
For the IRC freaks. Simply echoed as a tweet, /me included.
/ruler (/ru)
Prints a "ruler," 140 characters wide plus the size of the prompt, as a convenient visual aid.
/quit (/q)
Leaves ttytter. Pressing CTRL-D or CTRL-C will also do this. It's preferable to use this command (or those keysequences) to exit ttytter because if you kill the console process outside of ttytter, the background process may not get cleaned up and will have to be killed separately. This immediately stops anything running in the background, including pending requests for new tweets or DMs. If you want to wait for these to complete, use /end (/e).

Direct messaging

Direct messages are handled like any other tweet, except they appear with special formatting to set them apart. Because most people receive more tweets than DMs, DM checks are handled less frequently than regular tweets (the default is to check every fourth time interval). Any new DMs are then displayed as part of the tweet stream.

If your terminal supports ANSI colour sequences (or you force it on with -ansi), then DMs that you receive appear in green.

Since ttytter does not save state (on purpose), it doesn't know where you left off in your DM inbox. When you start ttytter, it will display the two most recent DMs and their time stamps. If both are new to you, a quick /dmagain will show you the full last twenty to see if there are any others.

To send a direct message, use the Twitter D command, e.g., D zaphod trillian is gonna kill you when you get home you two-faced jerk. This command is handled by Twitter, not TTYtter.

See the -dmpause option below.

Following and leaving users (and other Twitter-handled commands)

As you might expect, since Twitter accepts the D command to send direct messages, it will also accept the other specific commands supported for phones and IM (see the official list), including FOLLOW username and LEAVE username. Remember, these commands are handled by Twitter -- TTYtter simply passes them along.

The only commands that presently are not supported are ones that "talk back" to you, such as FOLLOWERS, STATS, etc., because TTYtter currently doesn't do anything with the server response after a tweet except to check that it's there (thus considered "successful").

Command history ("re-tweeting")

A simple one-command history (the "re-tweet") allows you to recall the last command. Instead of using !!, which can sometimes start (or be) a tweet, the last command is recalled with %%, and can be appended to. If the last tweet was too long, the truncated version is added to the history, allowing you to approve or append to it (and you are reminded of the new length in 0.8.2+). For example,

TTYtter> this is an attempt at a really long tweet which will almost certainly be greater than one hundred and forty characters even without UTF-8 overhead.
*** sorry, tweet too long by 7 characters; truncated to "this is an attempt at a really long tweet which will almost certainly be greater than one hundred and forty characters even without UTF-8" (137 chars)
*** use %% for truncated version, or append to %%.
TTYtter> now is the time
TTYtter> %% for all good men to eat pizza
(expanded to "now is the time for all good men to eat pizza")
TTYtter> <doctorlinguist> now is the time
<doctorlinguist> now is the time for all good men to eat pizza
[DM cbqueue/Mon Oct 01 07:31:54 +0000 2007] stop doing that

Starting with 0.6, a full command history is available, by default the last twenty in a session. Just as %% replaces !! for the immediately preceding command, so does, say, %-3 replace !-3 to retrieve (in our example) the command you entered three lines ago. If you add a :p (e.g., %-3:p) it will print it for you, or you can type /history to see all the commands in the buffer. :p and /history don't get added to the history themselves, but all other commands and tweets are. %% also still works just like before.

You can only append after the re-tweet, not prepend before it (although /%% is allowed to let you escape tweets that look like commands). This is on purpose due to the risk of ambiguity. Thus, something like you can get the third command with %-3 is tweeted out without substitution, but %-3 and Phyllis does get substituted.

Starting with 0.8, there is now primitive tweet editing. Since one common thing is to try to take words off the end, you can now do this by adding -x to the end of a history command (or -- for one word only). For example, %%-- takes the last word off the last command and resends that, or for a more complex example, %-2-4 takes the command two lines ago, and takes four words off that. You can then append to this construct, e.g., %-3-2 with Phyllis I mean. Note that this does not work with :p.

Command-line options

There are many useful options you can pass on the command line. Not all options are supported in prior versions; see the changelog below for when support for a particular option was added.

-user=[name]:[passwd] (required, except if you specify -anonymous [see below])
Specifies username and password. If you have a password like pa$$word that has shell metacharacters in it, try a command string like ./ttytter '-user=screwtape:pa\$\$word' (note single quotes around entire option, and backslashes before the metacharacters). If you want to explicitly override this and access Twitter without authentication, look at -anonymous.
-seven (optional and deprecated)
Specifies that UTF-8 support should not be enabled. As of the current implementation of the Twitter API, this does not affect receiving already decoded UTF-8 characters (assuming your terminal can display them), but it disables encoding UTF-8 characters so that you cannot tweet in UTF-8, and \u or HTML-encoded entities outside of normal ASCII will be rendered as dots. If Perl complains it has no UTF-8 support and/or can't find utf8.pm, pass this option, especially for older Perls. This option is mostly for impoverished Perls, as well as those systems still using 5.005; you should not use it if you can avoid it.
-lynx and -curl (optional)
Forces ttytter to use Lynx or cURL respectively. If the one you want isn't installed, an error occurs. If you don't specify, ttytter will try cURL, and then Lynx if it's not found.

Starting in 0.8.2, you can specify an absolute filename to the cURL or Lynx binary you want to use (e.g., -lynx=/weird/bin/lynx). This is useful for running in improverished circumstances where you might not have (or might not trust?) your environment variables, or if the program is not usually in your PATH.

-ansi and -noansi (optional)
Forces ttytter to enable or disable ANSI colour sequences, respectively. If you don't specify, ttytter turns on ANSI colour if your terminal type given in the $TERM environment variable is either ansi or xterm-color (xterm is intentionally not included because of variable support between implementations), and uses no special terminal sequences otherwise. -noansi overrides -ansi, so if you pass both together, then -ansi is ignored. This is also true for -script, which implies -noansi (see -script).
-pause=[pause] (optional)
Specifies the timeout in seconds for the background process. If you don't specify, the timeout is 120 seconds between refreshes, which is designed not to hit the remote server too hard. Remember that setting this too low and thus grabbing tweets from twitter.com too often may cause you to be temporarily prevented from getting them later if you exceed the rate limit (see the FAQ below), so leave this as is unless you have a good reason. You can always bounce this manually with /refresh.

Starting in 0.8, if you specify -pause=0, then all updates (including DMs) are disabled and must be requested manually. This is forced if you specify -script (see -script).

-dmpause=[interval] (optional)
Specifies the ratio of updates for direct messages. The default is four, so every fourth check for tweets, a direct messages check is done too. If you decrease this to 1:1, keep in mind you may hit the rate limit depending on what your timeout is.

If you set this to zero, automatic DM checking is disabled. However, you can still do manual refreshes with /dmrefresh and /dmagain; note that all messages are considered "new" the first time you query in this mode, so you'll get a full twenty with the initial request.

DM checking is also disabled if you are anonymous (see -anonymous), or if -pause is also zero (such as with -script; see -script).

-status=[status text] (optional)
Allows you to use ttytter as a command line tool, like from a cron job or shell script, and automatically post the provided text and exit. You should probably quote the text (e.g., -status="Yo mama is so fat") or your shell may eat portions of it. You cannot use this option if you are anonymous (see -anonymous). See Scripting TTYtter below. This is usually more efficient than posting with -script (below).

You can also use this with -daemon (below) so that you can post from the command line while still using your shell, and having the background process asynchronously monitoring tweets like usual.

-script (optional)
Forces a specialized mode designed for running commands from a script file or passed via standard input. -script implies (forces) -noansi, -pause=0 and -silent. This is optimized for automatic or unattended command sequences performing simple tasks. See Scripting TTYtter below.

Note that for posting single tweets, -status is generally more efficient than -script.

-timestamp=[template] (optional)
Forces timestamps to appear on all tweets, all the time, instead of just on direct messages. If you just say -timestamp with no argument, then the server-provided GMT timestamp is used without further customization or localization. On the other hand, if you have Date::Parse and Date::Format (both part of TimeDate), then you can specify a template to which it will be formatted and displayed instead as an argument (an argument of default will invoke the default of "%Y-%m-%d %k:%M:%S"). If these modules do not exist, then trying to use a timestamp template will cause a fatal error.
-silent (optional)
Redirects stdout to the bitbucket, rendering ttytter mute. This is really stupid to do in interactive mode but may be very useful for scripts, or -daemon or -status. Exit status is still returned in the usual convention so shell scripts with && and || work as expected, and tweets and DMs will still appear in 0.8+ (but nothing else).
-hold (optional)
If Twitter is being recalcitrant and you know that your login information and URL are correct, you can make ttytter automatically retry the initial test connection every three minutes until it gets through. Since this is not what a first-time user will want to do, this option is not the default. However, once you're set up, consider adding it if the kittens-of-death are using the Obvious server room for a scratching post.

-hold also works for -status, in which case it keeps trying until the tweet is transmitted.

-anonymous (optional, except if you do not specify -user)
Indicates that you will not be using an authenticated username to read tweets. (You must either explicitly indicate this option, or otherwise use -user; there is no "implied anonymity.") When anonymous mode is enabled, there are several significant changes:

This is mostly useful for bots, or the voyeuristic sort that wants to watch what's going on and snoop on users without getting hits on their rate limit. Also, because you don't need to get any credentials checked, access is much quicker in anonymous mode, which again is also good for bots.

If you specify both -user and -anonymous, -anonymous takes precedence and user credentials are not transmitted.

-url=[url] (optional)
Specifies the source for tweets. Tweets are only accepted in JSON format, not XML or RSS. If you don't specify, tweets are downloaded from your friends list at twitter.com (or, if you are anonymous, from the public timeline at same). For example, you can specify you always want the public timeline with this, even if you're authenticated; see the Twitter API for the relevant URLs.

If you want to use this to specify an SSL URL (https://), read the section on TTYtter and SSL.

-dmurl=[url] (optional)
Specifies the source for direct messages, again in JSON format. If you don't specify, direct messages are downloaded from your inbox at twitter.com. This is ignored if you are anonymous. If you want to use this to specify an SSL URL (https://), read the section on TTYtter and SSL.
-rurl=[url] (optional)
Specifies the source for replies, once again in JSON format. If you don't specify, replies are downloaded from your source at twitter.com. This is ignored if you are anonymous. If you want to use this to specify an SSL URL (https://), read the section on TTYtter and SSL.
-uurl=[url] (optional)
Specifies the user timeline URL. This is a little odd in that this URL is actually specified incompletely as a template upon which ttytter builds the actual URL it accesses. If you don't specify, user timelines are downloaded using the URL http://twitter.com/statuses/user_timeline as a base, which is expanded to http://twitter.com/statuses/user_timeline/username.json. Again, all data should be in JSON format. This applies to authenticated and anonymous users. If you want to use this to specify an SSL URL (https://), read the section on TTYtter and SSL.
-wurl=[url] (optional)
Specifies the user query URL. Like -uurl, this is a partial URL that ttytter uses as a template. If you don't specify, user information is downloaded using the URL http://twitter.com/users/show as a base, which is expanded to http://twitter.com/users/show/username.json. Again, all data should be in JSON format. This applies to authenticated and anonymous users. If you want to use this to specify an SSL URL (https://), read the section on TTYtter and SSL.
-frurl=[url] (optional)
Specifies the relationship query URL, which is given user_a and user_b arguments and is expected to return a JSON true or false result. If you don't specify, Twitter is queried directly for relationship statuses. This is ignored if you are anonymous. This was disabled in 0.8.4 due to problems in the Twitter API and is currently a no-op in 0.8.5. If you want to use this to specify an SSL URL (https://), read the section on TTYtter and SSL.
-update=[url] (optional)
Specifies the update URL. Although nothing is much done with the returned confirmation except to check that it's there, the URL should still return something useful in JSON format. This option allows you to use a third-party posting service if you like, assuming it supports the Twitter API. If you don't specify, tweets are sent to the standard one at twitter.com. This is ignored if you are anonymous. If you want to use this to specify an SSL URL (https://), read the section on TTYtter and SSL.
-avatar (optional)
Specifies a command to be passed to your shell for processing the picture URL from /whois. The string %U in your command is replaced with the URL, which is single-quoted automatically for you to avoid metacharacter madness. The return code is not checked and your command can do anything that it wants; I use this for displaying avatar images in ASCII art with commands like this:

Note that in both these cases you will need the requisite image converter installed (namely djpeg and ImageMagick respectively), but you can use whatever image converter you want.

Here is an example of the output (the image is inverted because this was originally from a light-on-dark terminal).

-verbose (optional)
Prints additional status information. Sometimes spammy. There is another version of this option with really really spammy output, but those who need to use it should be able to figure it out themselves.
-maxhist=[entries] (optional)
Number of entries to add to the history buffer. Since the history buffer is always at least one command long, the total number of history entries will be (maxhist + 1). The default is 19, making a twenty-line buffer.
-daemon (optional)
Launches ttytter's background process detached so that you return to the shell immediately, but tweets are still being monitored. In this mode you can use TTYtter in the background while you still use your shell and tweet manually from it with -status=.... This is also how you could set up a stand-alone Twitter bot. See below.
-lib=[filename] (optional)
Used for installing extensions. See below.
-twarg=[argument] (optional)
Specifies a user defined argument string, where you can pass any data you like. TTYtter doesn't make any use of this by definition, but your extension library can by looking at $twarg. See below. If you plan to pass spaces or shell metacharacters, they should be escaped or quoted as with any other argument.

If you have a set of options you like, or don't like giving your password out on the command line, you can make a file .ttytterrc in your home directory and put options in it like so (note that options without an argument are specified with a value of 1):

user=screwtape:wormwood
hold=1
lynx=1
url=http://twitter.com/statuses/public_timeline.json

Blank lines and lines starting with # are ignored. If your password has shell metacharacters in it, they must be backslashed (e.g. pa\$\$word).

If you specify command line options, they override anything in .ttytterrc. To negate a Boolean option, specify it with a value of zero, e.g., to disable the -hold option using the example .ttytterrc above, pass -hold=0.

TTYtter and SSL

For modern versions of either Lynx or cURL, OpenSSL is mandatory for the following section.

TTYtter supports encryption as long as your Lynx or cURL does, since obviously the network lifting is done by Lynx or cURL, not TTYtter. For this reason, since not everyone has a crypto-enabled client, SSL is not enabled by default. Note that this means passwords are encoded only using HTTP Basic Authentication and updates are sent and received in the clear, which may be a problem if you require high security for your application or are on an insecure link such as open wireless.

If your client does support SSL, then you can easily change TTYtter to use it (do note that this may scale less well due to the additional overhead). This requires changing the relevant URLs using the options above, or you can cut and paste this into your .ttytterrc file:

url=https://twitter.com/statuses/friends_timeline.json
rurl=https://twitter.com/statuses/replies.json
uurl=https://twitter.com/statuses/user_timeline
wurl=https://twitter.com/users/show
update=https://twitter.com/statuses/update.json
dmurl=https://twitter.com/direct_messages.json
frurl=https://twitter.com/friendships/exists.json

By default, cURL's certificate bundle is old and may not support Twitter's current CA. cURL offers an updater script in Perl which will rebuild a new certificate bundle suitable for installation, which requires LWP, along with the standard Getopt and MIME modules. (A more current version may have already come with your cURL install.) If you need a version of this updater script for systems without LWP (like Mac OS X) and don't want to install LWP to run it, I offer a modified version using cURL itself.

For Lynx users, if you get certificate errors, read how to manage certificates in Lynx.

Scripting TTYtter

TTYtter can be easily scripted by passing it console commands on standard input (and tweets, although if you are doing a single tweet -status=... works much better and can be made 'bulletproof' with -hold to boot). For many custom applications where you just need, say, a cron job to fetch your last 20 DMs, this can be all you need.

In 0.8, scripting was greatly expanded to allow even asynchronous commands to be fully scriptable, and extensions made to allow for an optimal script environment. Most of the time, you will want to use -script to ensure that you have full control over the environment and that prompts are suppressed, and then feed your list of commands into ttytter. For example, if you pipe this to ttytter -script,

/r
/dm
/end

TTYtter will fetch your 20 most recent tweets on the timeline (since /r will start from the beginning, having no history), your 20 most recent direct messages, and then wait for those requests to end before quitting (if you omitted the last line, an end-of-file is treated as /quit and any outstanding queued requests will be immediately cancelled -- usually not what you want in a script). Everything is emitted to standard input.

You don't even need to use a file at all, of course, and naturally you can pipe it to something else such as in this marginally useless example:

echo "/again twitterapi" | ttytter -script -anonymous | grep -i banana

Any command that the console understands can be passed, even history substitutions and actual tweets.

This suffices for simple tasks, but you cannot change the format of tweets this way (except with things like -timestamp), and there is no reliable error detection or conditional logic. For much more custom behaviour, you need to write an extension in Perl, which brings us to ...

Extending TTYtter with custom behaviour and filtering (-lib)

If scripting isn't enough, you can completely override the engine's guts for your specific purpose. Using the -lib=... option, you can specify a custom library to augment TTYtter's core behaviour, including but not limited to how received tweets and DMs are dealt with, how errors are reported or even how the console itself is handled. You can either use this in interactive mode, or, if you use -daemon, even make a Twitter bot.

For more information on this very useful function, see Advanced usage. This page is intended for 0.9 users.

Using TTYtter as a bot or daemon (-daemon)

If you launch ttytter as a detached process using the -daemon option, it will immediately return but after installing a background process that monitors tweets and direct messages just like the asynchronous monitor does in interactive mode. The PID of the new background process is printed for your reference.

If you just pass -daemon and don't specify any custom behaviour with -lib=..., then tweets and DMs are printed asynchronously in the background and you can watch them while you use the terminal session for something else (it will just print over what you're doing). However, you must do something like ttytter -status=... to post tweets, as there is no console process, and you must kill the daemon process manually to turn it off.

Combine -daemon with the -lib=... option and, as mentioned above, you can use ttytter as a Twitter bot. Again, for more information on this very useful function, see Advanced usage. This page is intended for 0.9 users.

To-do

Other notes

Frequently asked questions (read first! before you download!)

Download and change-log

Subscribe to updates over Twitter! -- twitter.com/ttytter (or visit Floodgap Updates)

ttytter has been tested against Perl 5.0050x running on AIX with Lynx 2.8.2, Perl 5.8.6 running on Mac OS X 10.4.11 with curl 7.13.1, Perl 5.6.1 and 5.8.8 running on NetBSD/macppc with Lynx 2.8.5, and Perl 5.8.8 running on the OLPC XO-1 Build 650 (Linux) with curl connecting both directly and through an HTTP proxy (configured for Lynx/curl). It is guaranteed to make Larry Wall nauseous just looking at it. There are also successful reports from users of Cygwin.

Changes in version 0.8.6:

Changes in version 0.8.5:

Changes in version 0.8.4:

Changes in version 0.8.3:

Changes in version 0.8.2:

Changes in version 0.8.1:

Changes in version 0.8.0:

Changes in version 0.7.1:

Changes in version 0.7.0:

Changes in version 0.6.1:

Changes in version 0.6.0:

Changes in version 0.5.1:

Changes in version 0.5:

Changes in version 0.4:

Changes in version 0.3:

Changes in version 0.2:

Send comments and blank cheques to ckaiser@floodgap.com.
Cameron Kaiser