Since Twitter is disabling free API access, I am admitting what has been the case for years: oysttyer is no longer maintained.

The official fork and replacement for what was once Floodgap's TTYtter.

In order to get Cameron Kaiser's blessing, we've had to change the name, take out a new API key and keep the Floodgap Free Software License.

The master branch will be pretty much what I'm running, but that doesn't mean I've not managed to break it in someway; Tagged releases (i.e. X.X.X) are intended to be stable. The mirror branch reflects all the historical official TTYtter updates.

See the oysttyer User Guide for usage information.

1. You have to re-authorise (you can't use your .ttytterkey) as we have a new API key
2. Move/rename your .ttytterc file to .oysttyerrc
3. If you use the ttytteristas pref it is now called oysttyeristas
4. Read the Changelog to see what's new since TTYtter 2.1

I think that's it?

Depending on how you obtain oysttyer the file could already be executable so you can launch it directly (./oysttyer.pl) as long as the shebang matches your path to Perl or you alter the shebang so it does. However, it's probably a lot easier just to do:

perl oysttyer.pl

Since the transition from TTYtter, Twitter seem to be in the habit of muzzling us (their word for blocking write access). This is done at the oysttyer oauthkey/secret level so affects all users. As a (hopefully) temporary work-around until we can resolve this issue permanently with Twitter you can register our own app (You can call it whatever, but if you are stuck for a name call it "oysttyer-") and specify the oauthkey and oauthsecret in the .oysttyerrc file:

oauthkey=xxXxxXxxXXXXXxXxxxXXXxxXX
oauthsecret=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Be sure to avoid trailing whitespace in your key/secret. You will, of course, have to re-authorise and get a new token. I suggest taking advantage of the existing keyfile functionality in oysttyer to do this. Important: If you are using you own oauthkey and oauthsecret to get a new token then that token will only work with your own oauthkey and oauthsecret. Tokens are not interchangeable between oauthkeys and oauthsecrets.

Until we catch up with the documentation, check out the changelog and commitlog, etc.

1. The TTYtter_VERSION, TTYtter_PATCH_VERSION and TTYtter_RC_NUMBER variables are now oysttyer_VERSION, oysttyer_PATCH_VERSION and oysttyer_RC_NUMBER.
2. User-agent string has changed to oysttyer/$oysttyer_VERSION.

I strongly suggest, although it is by no means compulsory, tracking @oysttyer and #oysttyer as that way you become connected to a global support network.

Also, check out some available extensions:

• oysttyer-profile update your profile information from within oysttyer
• oysttyer-deshortify gets rid of shortlinks and displays final URLs
• oysttyer-multigeo for all your geographical location needs