Mastostream console Mastodon viewer

This is a crude client for Mastodon, loosely based on the command line client Toot.

Mastostream's speciality is providing a very minimal way of keeping up with posts, doing a couple of simple on-the-fly actions like favouriting or responding to polls, and bookmarking anything you want to reply to properly for later. The place on the timeline you read to is automatically saved so that the client can resume showing you toots wherever you left off.

Features

• remembers where you got to in your home timeline
• favourite, vote, and bookmark from hotkeys
• content warning-ed toots are hidden until interacted with
• shortcuts for viewing media using external programs
• shows a new notifications counter when starting up

Usage

Edit the configuration values at the top of mastostream.py to set your instance and preferred media viewing programs. You should then be able to run it in a terminal:

$ python3 mastostream.py

I've tested Mastostream on Linux, it will likely work on OS X, and in theory it supports Windows but I haven't tested it there.

Dependencies

• Python 3.x

When first run Mastostream will ask you to log in, hopefully the instructions it gives are fairly clear. The process is:

• run Mastostream, it will say “no saved access token, press enter to login”
• it will ask your instance for an access token
• Mastostream will say “please login and paste resulting code” and give you a URL to open
• the URL should be a page on your instance that will let you log in and confirm permissions
• if you confirm, the page will give you a code to paste into Mastostream
• Mastostream should then say “log in” and “access token saved” and display your timeline

Mastostream displays a list of key bindings below posts, these are:

• [space] show next post
• [q] quit
• [i] show post information (URL, favourites, boosts)
• [t] show preceding thread and replies (this can be finicky)
• [f] favourite post
• [b] bookmark post
• [0]-[9] view media
• [a]-[z] vote in poll

Visibility icons:

• ☼ (green) public
• ☀ (green) unlisted
• ⨯ (yellow) followers only
• ✉ (red) mentioned only

Reply icons:

• ⇕ reply to a thread, has replies
• ⇓ first in a thread, has replies
• ⇑ reply to a thread, has no replies
• - first in a thread, has no replies

License

GPL v3.