No description
Find a file
2017-04-15 12:00:22 +02:00
toot Allow attaching media files to posts 2017-04-15 12:00:22 +02:00
.gitignore Initial commit 2017-04-12 16:43:30 +02:00
CHANGELOG.md Bump version to 0.3.0 2017-04-13 13:53:37 +02:00
LICENSE Add license 2017-04-12 17:16:08 +02:00
Makefile Initial commit 2017-04-12 16:43:30 +02:00
README.rst Allow attaching media files to posts 2017-04-15 12:00:22 +02:00
requirements-dev.txt Add dev reqirements file 2017-04-13 13:16:41 +02:00
setup.cfg Initial commit 2017-04-12 16:43:30 +02:00
setup.py Bump version to 0.3.0 2017-04-13 13:53:37 +02:00

=============================
Toot - Mastodon CLI interface
=============================

Interact with Mastodon social networks from the command line.

.. 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


Installation
------------

Install using pip:

.. code-block::

    pip install toot


Usage
-----

Firstly, you will need to login to a Mastodon instance:

.. code-block::

    toot login

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/app.cfg``
* ``~/.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

Show timeline
~~~~~~~~~~~~~

To show recent items in your public timeline:

.. code-block::

    toot timeline

Post status
~~~~~~~~~~~

To post a new status to your timeline:

.. code-block::

    toot post "Hello world!"

Optionally attach an image or video to the status:

    toot post "Hello world!" --media=path/to/world.jpg