I used
toot for some time as a Mastodon client for my beloved terminal. Back then I had two clients.
toot and
tut. The latter was not available in the NixOS packages with a current version for a long time, but that has now changed.
0x01 - INSTALLATION
I had already written about
TOOT. At the time it was the second choice as a
Mastodon terminal client. Now the packages for
tut have been updated and are available for installation.
Of course, installation via NixOS configuration.nix is as simple as ever:
configuration.nix
environment.systemPackages = [
pkgs.tut
];
That's the whole magic.
0x02 - USAGE
The
tut interface is very clear. On the left there is a column with the timeline in the upper half and the notifications in the lower half.
The post content is displayed on the right. Simple and useful.
Using
tut is Vim-inspired, i.e. commands start with a colon (:).
But before I go into the commands, let's take a quick look at the post-specific commands.
There is the option to react directly to posts in the timeline:
TUT
F - Favorites/Likes the post
B - Boosted / Shares the post
T - Shows the entire history if there are multiple replies
R - Replies
V - Lets you scroll through longer posts
U - Shows the user's latest posts
M - Shows the images/videos in an external tool
A - Shows the user's avatar in an external tool
S - Save post
Y - Copy post
These keys cover a few basic functions, at least if you are just reading and interacting.
But if you want to post yourself, see other timelines and other things, then you need the commands mentioned above.
0x03 - COMMANDS
As in
VIM, commands start with
: followed by the desired command.
tut has the very convenient function that when you enter ":", a list of all available commands is displayed immediately.
After selecting the command, you also get suitable parameters that you can feed
tut.
This way you can easily work your way through the parameters and I think it is quite convenient, especially for beginners.
The following commands are available:
TUT
:blocking - Users you have blocked
:boosts - Users who have boosted a post
:bookmarks - Your bookmarks
:clear-notifications - Removes all notifications
:clear-temp - Deletes all temporarily downloaded media files
:close-pane - Closes the current panel
:compose - Compose a toot (see below)
:favorites - Users who have favorited a post
:favorited - Posts you have favorited
:follow-tag - Follow a hashtag
:followers - Who you follow
:following - Your followers
:help - The help file
:h - The help file
:history - Shows the edit history
:move-pane - Moves the panel
:next-acct - Next account (multi-account setup)
:lists - Show your lists
:list-placement - Position of the lists panel
:list-split - Splits the timelines vertically or horizontally
:login - Add account
:muting - Users you have muted
:newer - Loads new posts
:preferences - Update profile
:prev-acct - Previous account (multi-account setup)
:profile - Your profile
:proportions - The proportions of the panels
:refetch - Reloads the current item
:requests - Requests
:saved - Saved posts
:stick-to-top - Always shows selected post at the top
:tag - Shows posts with #Tag
:timeline - Opens a timeline (see below)
:tl - Opens a timeline (see below)
:unfollow-tag - Unfollow tag
:user $user - Searches for username
:pane - Ends tut
:q - Ends tut
So there are a whole host of options for controlling Mastodon from the terminal.
A few small special features can be seen in the commands
:timeline and
:compose.
0x04 - :TIMELINE
If you use Mastodon with the web client, you have limited options for displaying timelines. In
tut there are a few more.
The command
:timeline has a few parameters that control which timelines you can display:
:timeline
:tl home - Home Timeline
:tl local - Local instance timeline
:tl federated - Federated timeline
:tl direct - Direct messages
:tl notifications - Notifications
:tl mentions - Mentions
:tl favorited - Your favorite posts
Another special feature is the
:compose command.
0x05 - :COMPOSE
:compose opens a new window for writing a post. Here you have all the options that you have in the web interface.
At the top right of the window you can see a status of the parameters used such as CW, visibility and the like. At the bottom, as everywhere in
tut, are the commands you can use:
:compose
P - Send your post
E - Edit post
V - Visibility
T - Enable/Disable CW
C - CW Text
M - Add/Delete Media File
O - Poll
L - Language
Even though
P is first, it is the last command you use because it sends your mail. The other commands should be self-explanatory.
0x06 - CONCLUSION
Once you get used to the controls,
tut is a powerful tool for using Mastodon via terminal and it looks great too. Definitely my new favorite client.