Fork 0
Go to file
Ivan Habunek e46a817f09
Exit with nonzero code on error
fixes #14
2017-05-08 09:11:20 +02:00
tests Search only accounts when looking for users 2017-05-07 10:42:04 +02:00
toot Exit with nonzero code on error 2017-05-08 09:11:20 +02:00
.gitignore Replace deprecated optparse with argparse 2017-04-16 14:06:16 +02:00
.travis.yml Drop support for Python 2.6 2017-04-15 14:55:27 +02:00
CHANGELOG.md Bump version 2017-05-07 10:44:24 +02:00
LICENSE Add license 2017-04-12 17:16:08 +02:00
Makefile Clear pyc files on `make clean` 2017-04-24 16:24:52 +02:00
README.rst Group commands contextually in print_help 2017-04-26 12:12:31 +02:00
requirements-dev.txt Replace deprecated optparse with argparse 2017-04-16 14:06:16 +02:00
requirements.txt Move requirements to requirements.txt 2017-04-26 11:16:22 +02:00
setup.cfg Initial commit 2017-04-12 16:43:30 +02:00
setup.py Bump version 2017-05-07 10:44:24 +02:00


Toot - Mastodon CLI interface

Interact with Mastodon social networks from the command line.

.. image:: https://img.shields.io/travis/ihabunek/toot.svg?maxAge=3600&style=flat-square
   :target: https://travis-ci.org/ihabunek/toot
.. image:: https://img.shields.io/badge/author-%40ihabunek-blue.svg?maxAge=3600&style=flat-square
   :target: https://mastodon.social/@ihabunek
.. image:: https://img.shields.io/github/license/ihabunek/pdf417-py.svg?maxAge=3600&style=flat-square
   :target: https://opensource.org/licenses/MIT
.. image:: https://img.shields.io/pypi/v/toot.svg?maxAge=3600&style=flat-square
   :target: https://pypi.python.org/pypi/toot


Install using pip:

.. code-block::

    pip install toot


Running ``toot`` displays a list of available commands.

Running ``toot <command> -h`` shows the documentation for the given command.

.. code-block::

    $ toot

    toot - a Mastodon CLI client

      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 account details
      toot search      Search for users or hashtags
      toot timeline    Show recent items in your public timeline
      toot curses      An experimental timeline app.

      toot post        Post a status text to your timeline
      toot upload      Upload an image or video file

      toot follow      Follow an account
      toot unfollow    Unfollow an account
      toot mute        Mute an account
      toot unmute      Unmute an account
      toot block       Block an account
      toot unblock     Unblock an account

    To get help for each command run:
      toot <command> --help


It is possible to pipe status text into `toot post`, for example:

.. code-block::

    echo "Text to post" | toot post
    cat mypost.txt | toot post


Before tooting, you need to login to a Mastodon instance:

.. code-block::

    toot login

**Two factor authentication** is supported experimentally, instead of ``login``, you should instead run ``login_2fa``:

.. code-block::

    toot login_2fa

You will be asked to chose an instance_ and enter your credentials.

.. _instance: https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/List-of-Mastodon-instances.md

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:

.. code-block::

    toot auth

And you can logout which will remove the stored access tokens:

.. code-block::

    toot logout