toot 0.7.0

Interact with Mastodon social networks from the command line.

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.

Command	Description
toot login	Log into a Mastodon instance.
toot 2fa	Log into a Mastodon instance using two factor authentication.
toot logout	Log out, deletes stored access keys.
toot auth	Display stored authenitication tokens.
toot whoami	Display logged in user details.
toot post	Post a status to your timeline.
toot search	Search for accounts or hashtags.
toot timeline	Display recent items in your public timeline.
toot follow	Follow an account.
toot unfollow	Unfollow an account.

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:

toot 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