1
0
mirror of https://github.com/ihabunek/toot synced 2024-12-23 15:37:47 +01:00
Toot-Mastodon-CLI-TUI-clien.../README.rst

76 lines
2.3 KiB
ReStructuredText
Raw Normal View History

2017-04-12 17:23:50 +02:00
=============================
Toot - Mastodon CLI interface
=============================
Interact with Mastodon social networks from the command line.
2017-04-16 15:07:27 +02:00
.. image:: https://img.shields.io/travis/ihabunek/toot.svg?maxAge=3600&style=flat-square
:target: https://travis-ci.org/ihabunek/toot
2017-04-12 17:23:50 +02:00
.. 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
2017-04-12 16:42:04 +02:00
Installation
------------
Install using pip:
.. code-block::
pip install toot
Usage
-----
2017-04-16 15:07:27 +02:00
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.
2017-04-16 17:52:54 +02:00
``toot auth`` Display stored authenitication tokens.
``toot whoami`` Display logged in user details.
2017-04-16 15:07:27 +02:00
``toot post`` Post a status to your timeline.
``toot search`` Search for accounts or hashtags.
``toot timeline`` Display recent items in your public timeline.
2017-04-16 17:15:05 +02:00
``toot follow`` Follow an account.
``toot unfollow`` Unfollow an account.
2017-04-16 15:07:27 +02:00
=================== ===============================================================
Authentication
--------------
Before tooting, you need to login to a Mastodon instance:
2017-04-12 16:42:04 +02:00
.. code-block::
2017-04-13 13:52:28 +02:00
toot login
You will be asked to chose an instance_ and enter your credentials.
2017-04-12 16:42:04 +02:00
2017-04-13 13:52:28 +02:00
.. _instance: https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/List-of-Mastodon-instances.md
2017-04-12 17:18:56 +02:00
2017-04-13 13:52:28 +02:00
The application and user access tokens will be saved in two files in your home directory:
2017-04-12 17:18:56 +02:00
* ``~/.config/toot/app.cfg``
* ``~/.config/toot/user.cfg``
2017-04-13 13:52:28 +02:00
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