Toot - Mastodon CLI interface
Interact with Mastodon social networks from the command line.
Installation
Install using pip:
pip install toot
Usage
Running toot
displays a list of available commands.
Running toot <command> -h
shows the documentation for the given command.
$ toot toot - a Mastodon CLI client Usage: toot login Log into a Mastodon instance toot login_2fa Log in using two factor authentication (experimental) toot logout Log out, delete stored access keys toot auth Show stored credentials toot whoami Display logged in user details toot whois Display user details toot post Post a status text to your timeline toot upload Upload an image or video file toot search Search for users or hashtags toot follow Follow an account toot unfollow Unfollow an account toot timeline Show recent items in your public timeline toot curses An experimental timeline app. To get help for each command run: toot <command> --help https://github.com/ihabunek/toot
It is possible to pipe status text into toot post, for example:
echo "Text to post" | toot post cat mypost.txt | toot post
Authentication
Before tooting, you need to login to a Mastodon instance:
toot login
Two factor authentication is supported experimentally, instead of login
, you should instead run login_2fa
:
toot login_2fa
You will be asked to chose an instance and enter your credentials.
The application and user access tokens will be saved in two files in your home directory:
~/.config/toot/instances/<name>
- created for each mastodon instance once~/.config/toot/user.cfg
You can check whether you are currently logged in:
toot auth
And you can logout which will remove the stored access tokens:
toot logout