💾 Archived View for tilde.team › ~fudge › mastostream › index.gmi captured on 2024-07-09 at 00:07:26. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

Mastostream console Mastodon viewer

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

Toot's homepage

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

Source code zip

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

Screen: instance confirmation dialogs and application description

Screenshot: just after logging in

Screenshot: annotated Mastostream post view

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.