Interact with Mastodon social networks from the command line.
Project description
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, saves access keys for later use. |
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
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/app.cfg
~/.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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.