Skip to main content

Interact with Mastodon social networks from the command line.

Project description

Interact with Mastodon social networks from the command line.

https://img.shields.io/badge/author-%40ihabunek-blue.svg?maxAge=3600&style=flat-square https://img.shields.io/github/license/ihabunek/pdf417-py.svg?maxAge=3600&style=flat-square https://img.shields.io/pypi/v/toot.svg?maxAge=3600&style=flat-square

Installation

Install using pip:

pip install toot

Usage

Firstly, you will 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

Show timeline

To show recent items in your public timeline:

toot timeline

Post status

To post a new status to your timeline:

toot post "Hello world!"

Optionally attach an image or video to the status:

toot post “Hello world!” –media=path/to/world.jpg

To set post visibility:

toot post “Hello world!” –visibility=unlisted

Possible visibility values are: public (default), unlisted, private, direct. They are documented here.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
toot-0.4.0-py2.py3-none-any.whl (8.3 kB) Copy SHA256 hash SHA256 Wheel py2.py3
toot-0.4.0.tar.gz (5.8 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page