1
0
mirror of https://github.com/ihabunek/toot synced 2024-12-22 23:08:17 +01:00
Toot è uno strumento CLI (interfaccia Linea di Comando) per interagire con le istanze di Mastodon da riga di comando. Toot include un'interfaccia utente da terminaleTUI (Terminal User Interface).
Go to file
2017-04-13 13:53:37 +02:00
toot Require an explicit login 2017-04-13 13:52:28 +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 Require an explicit login 2017-04-13 13:52:28 +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!"