Remove readthedocs documentation
This commit is contained in:
parent
57824058e0
commit
5bd07e1756
14 changed files with 2 additions and 578 deletions
BIN
docs/_static/auth.png
vendored
BIN
docs/_static/auth.png
vendored
Binary file not shown.
|
Before Width: | Height: | Size: 26 KiB |
10
docs/_static/custom.css
vendored
10
docs/_static/custom.css
vendored
|
|
@ -1,10 +0,0 @@
|
||||||
pre {
|
|
||||||
padding: 8px 15px;
|
|
||||||
}
|
|
||||||
|
|
||||||
div.contents {
|
|
||||||
background-color: inherit;
|
|
||||||
border: 0;
|
|
||||||
margin-top: 0;
|
|
||||||
padding-top: 0;
|
|
||||||
}
|
|
||||||
BIN
docs/_static/trumpet.png
vendored
BIN
docs/_static/trumpet.png
vendored
Binary file not shown.
|
Before Width: | Height: | Size: 16 KiB |
BIN
docs/_static/tui_compose.png
vendored
BIN
docs/_static/tui_compose.png
vendored
Binary file not shown.
|
Before Width: | Height: | Size: 108 KiB |
BIN
docs/_static/tui_list.png
vendored
BIN
docs/_static/tui_list.png
vendored
Binary file not shown.
|
Before Width: | Height: | Size: 192 KiB |
BIN
docs/_static/tui_poll.png
vendored
BIN
docs/_static/tui_poll.png
vendored
Binary file not shown.
|
Before Width: | Height: | Size: 209 KiB |
5
docs/_templates/about.html
vendored
5
docs/_templates/about.html
vendored
|
|
@ -1,5 +0,0 @@
|
||||||
<h1 class="logo"><a href="{{ pathto(master_doc) }}">{{ project }}</a></h1>
|
|
||||||
|
|
||||||
{% if theme_description %}
|
|
||||||
<p class="blurb">{{ theme_description }}</p>
|
|
||||||
{% endif %}
|
|
||||||
|
|
@ -1,40 +0,0 @@
|
||||||
==============
|
|
||||||
Advanced usage
|
|
||||||
==============
|
|
||||||
|
|
||||||
Disabling HTTPS
|
|
||||||
---------------
|
|
||||||
|
|
||||||
You may pass the ``--disable-https`` flag to use unencrypted HTTP instead of
|
|
||||||
HTTPS for a given instance. This is inherently insecure and should be used only
|
|
||||||
when connecting to local development instances.
|
|
||||||
|
|
||||||
.. code-block:: sh
|
|
||||||
|
|
||||||
toot login --disable-https --instance localhost:8080
|
|
||||||
|
|
||||||
Using proxies
|
|
||||||
-------------
|
|
||||||
|
|
||||||
You can configure proxies by setting the ``HTTPS_PROXY`` or ``HTTP_PROXY``
|
|
||||||
environment variables. This will cause all http(s) requests to be proxied
|
|
||||||
through the specified server.
|
|
||||||
|
|
||||||
For example:
|
|
||||||
|
|
||||||
.. code-block:: sh
|
|
||||||
|
|
||||||
export HTTPS_PROXY="http://1.2.3.4:5678"
|
|
||||||
toot login --instance mastodon.social
|
|
||||||
|
|
||||||
**NB:** This feature is provided by
|
|
||||||
`requests <http://docs.python-requests.org/en/master/user/advanced/#proxies>`_
|
|
||||||
and setting the environment variable will affect other programs using this
|
|
||||||
library.
|
|
||||||
|
|
||||||
This environment can be set for a single call to toot by prefixing the command
|
|
||||||
with the environment variable:
|
|
||||||
|
|
||||||
.. code-block:: sh
|
|
||||||
|
|
||||||
HTTPS_PROXY="http://1.2.3.4:5678" toot login --instance mastodon.social
|
|
||||||
14
docs/conf.py
14
docs/conf.py
|
|
@ -10,7 +10,6 @@ author = 'Ivan Habunek'
|
||||||
# -- General configuration ---------------------------------------------------
|
# -- General configuration ---------------------------------------------------
|
||||||
|
|
||||||
extensions = []
|
extensions = []
|
||||||
templates_path = ['_templates']
|
|
||||||
source_suffix = '.rst'
|
source_suffix = '.rst'
|
||||||
master_doc = 'index'
|
master_doc = 'index'
|
||||||
exclude_patterns = ['_build']
|
exclude_patterns = ['_build']
|
||||||
|
|
@ -21,18 +20,5 @@ pygments_style = 'sphinx'
|
||||||
html_theme = 'alabaster'
|
html_theme = 'alabaster'
|
||||||
html_theme_options = {
|
html_theme_options = {
|
||||||
"description": "Mastodon CLI client",
|
"description": "Mastodon CLI client",
|
||||||
"github_user": "ihabunek",
|
|
||||||
"github_repo": "toot",
|
|
||||||
"fixed_sidebar": True,
|
"fixed_sidebar": True,
|
||||||
"travis_button": True,
|
|
||||||
"logo": 'trumpet.png',
|
|
||||||
}
|
|
||||||
html_static_path = ['_static']
|
|
||||||
html_sidebars = {
|
|
||||||
"**": [
|
|
||||||
"about.html",
|
|
||||||
"navigation.html",
|
|
||||||
"relations.html",
|
|
||||||
"searchbox.html",
|
|
||||||
]
|
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,72 +1,7 @@
|
||||||
toot - Mastodon CLI client
|
toot - Mastodon CLI client
|
||||||
==========================
|
==========================
|
||||||
|
|
||||||
.. image:: _static/trumpet.png
|
|
||||||
|
|
||||||
Toot is a CLI and TUI tool for interacting with Mastodon instances from the command line.
|
Toot is a CLI and TUI tool for interacting with Mastodon instances from the command line.
|
||||||
|
|
||||||
.. image:: https://img.shields.io/travis/ihabunek/toot.svg?maxAge=3600&style=flat-square
|
.. warning::
|
||||||
:target: https://travis-ci.org/ihabunek/toot
|
Toot documentation has moved to `toot.bezdomni.net <https://toot.bezdomni.net/>`_.
|
||||||
.. 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/toot.svg?maxAge=3600&style=flat-square
|
|
||||||
:target: https://opensource.org/licenses/GPL-3.0
|
|
||||||
.. image:: https://img.shields.io/pypi/v/toot.svg?maxAge=3600&style=flat-square
|
|
||||||
:target: https://pypi.python.org/pypi/toot
|
|
||||||
|
|
||||||
Resources
|
|
||||||
---------
|
|
||||||
|
|
||||||
* Homepage: https://github.com/ihabunek/toot
|
|
||||||
* Issues: https://github.com/ihabunek/toot/issues
|
|
||||||
* Documentation: https://toot.readthedocs.io/en/latest/
|
|
||||||
* Mailing list for discussion, support and patches:
|
|
||||||
https://lists.sr.ht/~ihabunek/toot-discuss
|
|
||||||
* Informal discussion: #toot IRC channel on `libera.chat <https://libera.chat/>`_
|
|
||||||
|
|
||||||
Features
|
|
||||||
--------
|
|
||||||
|
|
||||||
* Posting, replying, deleting, favouriting, reblogging & pinning statuses
|
|
||||||
* Support for media uploads, spoiler text, sensitive content
|
|
||||||
* Search by account or hash tag
|
|
||||||
* Following, muting and blocking accounts
|
|
||||||
* Simple switching between multiple Mastodon accounts
|
|
||||||
|
|
||||||
Contents
|
|
||||||
--------
|
|
||||||
|
|
||||||
.. toctree::
|
|
||||||
:maxdepth: 2
|
|
||||||
|
|
||||||
install
|
|
||||||
usage
|
|
||||||
advanced
|
|
||||||
release
|
|
||||||
|
|
||||||
Curses UI
|
|
||||||
---------
|
|
||||||
|
|
||||||
toot includes a curses-based terminal user interface (TUI). Run it with ``toot tui``.
|
|
||||||
|
|
||||||
.. image :: _static/tui_list.png
|
|
||||||
|
|
||||||
.. image :: _static/tui_poll.png
|
|
||||||
|
|
||||||
.. image :: _static/tui_compose.png
|
|
||||||
|
|
||||||
Development
|
|
||||||
-----------
|
|
||||||
|
|
||||||
The project source code and issue tracker are available on GitHub:
|
|
||||||
|
|
||||||
https://github.com/ihabunek/toot
|
|
||||||
|
|
||||||
Please report any issues there. Pull requests are welcome.
|
|
||||||
|
|
||||||
License
|
|
||||||
-------
|
|
||||||
|
|
||||||
Copyright Ivan Habunek <ivan@habunek.com> and contributors.
|
|
||||||
|
|
||||||
Licensed under `GPLv3 <http://www.gnu.org/licenses/gpl-3.0.html>`_.
|
|
||||||
|
|
|
||||||
123
docs/install.rst
123
docs/install.rst
|
|
@ -1,123 +0,0 @@
|
||||||
============
|
|
||||||
Installation
|
|
||||||
============
|
|
||||||
|
|
||||||
toot is packaged for various platforms.
|
|
||||||
|
|
||||||
.. contents::
|
|
||||||
:local:
|
|
||||||
:backlinks: none
|
|
||||||
|
|
||||||
Overview
|
|
||||||
--------
|
|
||||||
|
|
||||||
Packaging overview provided by `repology.org <https://repology.org/project/toot/versions>`_.
|
|
||||||
|
|
||||||
.. image :: https://repology.org/badge/vertical-allrepos/toot.svg
|
|
||||||
:alt: Packaging status
|
|
||||||
:target: https://repology.org/project/toot/versions
|
|
||||||
|
|
||||||
Debian & Ubuntu
|
|
||||||
---------------
|
|
||||||
|
|
||||||
Since Debian 10 (buster) and Ubuntu 19.04 (disco), toot is available in the
|
|
||||||
official package repository.
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
sudo apt install toot
|
|
||||||
|
|
||||||
Debian package is maintained by `Jonathan Carter <https://mastodon.xyz/@highvoltage>`_.
|
|
||||||
|
|
||||||
|
|
||||||
Arch Linux
|
|
||||||
----------
|
|
||||||
|
|
||||||
Install from `AUR <https://aur.archlinux.org/packages/toot/>`_.
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
yay -S toot
|
|
||||||
|
|
||||||
|
|
||||||
Fedora
|
|
||||||
-------------
|
|
||||||
|
|
||||||
Toot is available from the Fedora package repository.
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
sudo dnf install toot
|
|
||||||
|
|
||||||
|
|
||||||
FreeBSD ports
|
|
||||||
-------------
|
|
||||||
|
|
||||||
Install the package:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
pkg install py38-toot
|
|
||||||
|
|
||||||
Build and install from sources:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
cd /usr/ports/net-im/toot
|
|
||||||
make install
|
|
||||||
|
|
||||||
FreeBSD port is maintained by `Mateusz Piotrowski <https://mastodon.social/@mpts>`_
|
|
||||||
|
|
||||||
Nixpkgs
|
|
||||||
-------
|
|
||||||
|
|
||||||
This works on NixOS or systems with the Nix package manager installed.
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
nix-env -iA nixos.toot
|
|
||||||
|
|
||||||
|
|
||||||
OpenBSD ports
|
|
||||||
-------------
|
|
||||||
|
|
||||||
Install the package:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
pkg_add toot
|
|
||||||
|
|
||||||
Build and install from sources:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
cd /usr/ports/net/toot
|
|
||||||
make install
|
|
||||||
|
|
||||||
OpenBSD port is maintained by `Klemens Nanni <mailto:kl3@posteo.org>`_
|
|
||||||
|
|
||||||
Python Package Index
|
|
||||||
--------------------
|
|
||||||
|
|
||||||
Install from PyPI using pip, preferably into a virtual environment.
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
pip install --user toot
|
|
||||||
|
|
||||||
Homebrew
|
|
||||||
--------------------
|
|
||||||
|
|
||||||
This works on Mac OSX with `homebrew <https://brew.sh/>`_ installed.
|
|
||||||
Tested with on Catalina, Mojave, and High Sierra.
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
brew update
|
|
||||||
brew install toot
|
|
||||||
|
|
||||||
Source
|
|
||||||
------
|
|
||||||
|
|
||||||
Finally, you can get the latest source distribution, wheel or debian package
|
|
||||||
`from GitHub <https://github.com/ihabunek/toot/releases/latest/>`_.
|
|
||||||
|
|
@ -1,36 +0,0 @@
|
||||||
@ECHO OFF
|
|
||||||
|
|
||||||
pushd %~dp0
|
|
||||||
|
|
||||||
REM Command file for Sphinx documentation
|
|
||||||
|
|
||||||
if "%SPHINXBUILD%" == "" (
|
|
||||||
set SPHINXBUILD=sphinx-build
|
|
||||||
)
|
|
||||||
set SOURCEDIR=.
|
|
||||||
set BUILDDIR=_build
|
|
||||||
set SPHINXPROJ=toot
|
|
||||||
|
|
||||||
if "%1" == "" goto help
|
|
||||||
|
|
||||||
%SPHINXBUILD% >NUL 2>NUL
|
|
||||||
if errorlevel 9009 (
|
|
||||||
echo.
|
|
||||||
echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
|
|
||||||
echo.installed, then set the SPHINXBUILD environment variable to point
|
|
||||||
echo.to the full path of the 'sphinx-build' executable. Alternatively you
|
|
||||||
echo.may add the Sphinx directory to PATH.
|
|
||||||
echo.
|
|
||||||
echo.If you don't have Sphinx installed, grab it from
|
|
||||||
echo.http://sphinx-doc.org/
|
|
||||||
exit /b 1
|
|
||||||
)
|
|
||||||
|
|
||||||
%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
|
|
||||||
goto end
|
|
||||||
|
|
||||||
:help
|
|
||||||
%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
|
|
||||||
|
|
||||||
:end
|
|
||||||
popd
|
|
||||||
|
|
@ -1,35 +0,0 @@
|
||||||
=================
|
|
||||||
Release procedure
|
|
||||||
=================
|
|
||||||
|
|
||||||
This document is a checklist for creating a toot release.
|
|
||||||
|
|
||||||
Currently the process is pretty manual and would benefit from automatization.
|
|
||||||
|
|
||||||
Bump & tag version
|
|
||||||
------------------
|
|
||||||
|
|
||||||
* Update the version number in ``setup.py``
|
|
||||||
* Update the version number in ``toot/__init__.py``
|
|
||||||
* Update ``changelog.yaml`` with the release notes & date
|
|
||||||
* Run ``make changelog`` to generate a human readable changelog
|
|
||||||
* Commit the changes
|
|
||||||
* Run ``./scripts/tag_version <version>`` to tag a release in git
|
|
||||||
* Run ``git push --follow-tags`` to upload changes and tag to GitHub
|
|
||||||
|
|
||||||
Publishing to PyPI
|
|
||||||
------------------
|
|
||||||
|
|
||||||
* ``make dist`` to create source and wheel distributions
|
|
||||||
* ``make publish`` to push them to PyPI
|
|
||||||
|
|
||||||
GitHub release
|
|
||||||
--------------
|
|
||||||
|
|
||||||
* `Create a release <https://github.com/ihabunek/toot/releases/>`_ for the newly
|
|
||||||
pushed tag, paste changelog since last tag in the description
|
|
||||||
* Upload the assets generated in previous two steps to the release:
|
|
||||||
* source dist (.zip and .tar.gz)
|
|
||||||
* wheel distribution (.whl)
|
|
||||||
|
|
||||||
TODO: this can be automated: https://developer.github.com/v3/repos/releases/
|
|
||||||
248
docs/usage.rst
248
docs/usage.rst
|
|
@ -1,248 +0,0 @@
|
||||||
=====
|
|
||||||
Usage
|
|
||||||
=====
|
|
||||||
|
|
||||||
Running ``toot`` displays a list of available commands.
|
|
||||||
|
|
||||||
Running ``toot <command> -h`` shows the documentation for the given command.
|
|
||||||
|
|
||||||
.. code-block:: none
|
|
||||||
|
|
||||||
$ toot
|
|
||||||
|
|
||||||
toot - a Mastodon CLI client
|
|
||||||
v0.27.0
|
|
||||||
|
|
||||||
Authentication:
|
|
||||||
toot login Log into a mastodon instance using your browser (recommended)
|
|
||||||
toot login_cli Log in from the console, does NOT support two factor authentication
|
|
||||||
toot activate Switch between logged in accounts.
|
|
||||||
toot logout Log out, delete stored access keys
|
|
||||||
toot auth Show logged in accounts and instances
|
|
||||||
|
|
||||||
TUI:
|
|
||||||
toot tui Launches the toot terminal user interface
|
|
||||||
|
|
||||||
Read:
|
|
||||||
toot whoami Display logged in user details
|
|
||||||
toot whois Display account details
|
|
||||||
toot notifications Notifications for logged in user
|
|
||||||
toot instance Display instance details
|
|
||||||
toot search Search for users or hashtags
|
|
||||||
toot thread Show toot thread items
|
|
||||||
toot timeline Show recent items in a timeline (home by default)
|
|
||||||
|
|
||||||
Post:
|
|
||||||
toot post Post a status text to your timeline
|
|
||||||
toot upload Upload an image or video file
|
|
||||||
|
|
||||||
Status:
|
|
||||||
toot delete Delete a status
|
|
||||||
toot favourite Favourite a status
|
|
||||||
toot unfavourite Unfavourite a status
|
|
||||||
toot reblog Reblog a status
|
|
||||||
toot unreblog Unreblog a status
|
|
||||||
toot reblogged_by Show accounts that reblogged the status
|
|
||||||
toot pin Pin a status
|
|
||||||
toot unpin Unpin a status
|
|
||||||
|
|
||||||
Accounts:
|
|
||||||
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
|
|
||||||
|
|
||||||
https://github.com/ihabunek/toot
|
|
||||||
|
|
||||||
|
|
||||||
Authentication
|
|
||||||
--------------
|
|
||||||
|
|
||||||
Before tooting, you need to log into a Mastodon instance.
|
|
||||||
|
|
||||||
.. code-block:: sh
|
|
||||||
|
|
||||||
toot login
|
|
||||||
|
|
||||||
You will be redirected to your Mastodon instance to log in and authorize toot to
|
|
||||||
access your account, and will be given an **authorization code** in return which
|
|
||||||
you need to enter to log in.
|
|
||||||
|
|
||||||
The application and user access tokens will be saved in the configuration file
|
|
||||||
located at ``~/.config/toot/config.json``.
|
|
||||||
|
|
||||||
Using multiple accounts
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
It's possible to be logged into **multiple accounts** at the same time. Just
|
|
||||||
repeat the login process for another instance. You can see all logged in
|
|
||||||
accounts by running ``toot auth``. The currently active account will have an
|
|
||||||
**ACTIVE** flag next to it.
|
|
||||||
|
|
||||||
To switch accounts, use ``toot activate``. Alternatively, most commands accept a
|
|
||||||
``--using`` option which can be used to specify the account you wish to use just
|
|
||||||
that one time.
|
|
||||||
|
|
||||||
Finally you can logout from an account by using ``toot logout``. This will
|
|
||||||
remove the stored access tokens for that account.
|
|
||||||
|
|
||||||
Post a status
|
|
||||||
-------------
|
|
||||||
|
|
||||||
The simplest action is posting a status.
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot post "hello there"
|
|
||||||
|
|
||||||
You can also pipe in the status text:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
echo "Text to post" | toot post
|
|
||||||
cat post.txt | toot post
|
|
||||||
toot post < post.txt
|
|
||||||
|
|
||||||
If no status text is given, you will be prompted to enter some:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
$ toot post
|
|
||||||
Write or paste your toot. Press Ctrl-D to post it.
|
|
||||||
|
|
||||||
Finally, you can launch your favourite editor:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot post --editor vim
|
|
||||||
|
|
||||||
Define your editor preference in the ``EDITOR`` environment variable, then you
|
|
||||||
don't need to specify it explicitly:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
export EDITOR=vim
|
|
||||||
toot post --editor
|
|
||||||
|
|
||||||
Attachments
|
|
||||||
~~~~~~~~~~~
|
|
||||||
|
|
||||||
You can attach media to your status. Mastodon supports images, video and audio
|
|
||||||
files. For details on supported formats see `Mastodon docs on attachments
|
|
||||||
<https://docs.joinmastodon.org/user/posting/#attachments>`_.
|
|
||||||
|
|
||||||
It is encouraged to add a plain-text description to the attached media for
|
|
||||||
accessibility purposes by adding a ``--description`` option.
|
|
||||||
|
|
||||||
To attach an image:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot post "hello media" --media path/to/image.png --description "Cool image"
|
|
||||||
|
|
||||||
You can attach upto 4 attachments by giving multiple ``--media`` and
|
|
||||||
``--description`` options:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot post "hello media" \
|
|
||||||
--media path/to/image1.png --description "First image" \
|
|
||||||
--media path/to/image2.png --description "Second image" \
|
|
||||||
--media path/to/image3.png --description "Third image" \
|
|
||||||
--media path/to/image4.png --description "Fourth image"
|
|
||||||
|
|
||||||
The order of options is not relevant, except that the first given media will be
|
|
||||||
matched to the first given description and so on.
|
|
||||||
|
|
||||||
If the media is sensitive, mark it as such and people will need to click to show
|
|
||||||
it. This affects all attachments.
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot post "naughty pics ahoy" --media nsfw.png --sensitive
|
|
||||||
|
|
||||||
View timeline
|
|
||||||
-------------
|
|
||||||
|
|
||||||
View what's on your home timeline:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot timeline
|
|
||||||
|
|
||||||
Timeline takes various options:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot timeline --public # public timeline
|
|
||||||
toot timeline --public --local # public timeline, only this instance
|
|
||||||
toot timeline --tag photo # posts tagged with #photo
|
|
||||||
toot timeline --count 5 # fetch 5 toots (max 20)
|
|
||||||
toot timeline --once # don't prompt to fetch more toots
|
|
||||||
|
|
||||||
Status actions
|
|
||||||
--------------
|
|
||||||
|
|
||||||
The timeline lists the status ID at the bottom of each toot. Using that status
|
|
||||||
you can do various actions to it, e.g.:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot favourite 123456
|
|
||||||
toot reblog 123456
|
|
||||||
|
|
||||||
If it's your own status you can also delete pin or delete it:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot pin 123456
|
|
||||||
toot delete 123456
|
|
||||||
|
|
||||||
Account actions
|
|
||||||
---------------
|
|
||||||
|
|
||||||
Find a user by their name or account name:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot search "name surname"
|
|
||||||
toot search @someone
|
|
||||||
toot search someone@someplace.social
|
|
||||||
|
|
||||||
Once found, follow them:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot follow someone@someplace.social
|
|
||||||
|
|
||||||
If you get bored of them:
|
|
||||||
|
|
||||||
.. code-block:: bash
|
|
||||||
|
|
||||||
toot mute someone@someplace.social
|
|
||||||
toot block someone@someplace.social
|
|
||||||
toot unfollow someone@someplace.social
|
|
||||||
|
|
||||||
Using the Curses UI
|
|
||||||
-------------------
|
|
||||||
|
|
||||||
toot has a curses-based terminal user interface. The command to start it is ``toot tui``.
|
|
||||||
|
|
||||||
To navigate the UI use these commands:
|
|
||||||
|
|
||||||
* ``k`` or ``up arrow`` to move up the list of tweets
|
|
||||||
* ``j`` or ``down arrow`` to move down the list of tweets
|
|
||||||
* ``h`` to show a help screen
|
|
||||||
* ``t`` to view status thread
|
|
||||||
* ``v`` to view the current toot in a browser
|
|
||||||
* ``b`` to boost or unboost a status
|
|
||||||
* ``f`` to favourite or unfavourite a status
|
|
||||||
* ``q`` to quit the curses interface and return to the command line
|
|
||||||
* ``s`` to show sensitive content. (This is per-toot, and there will be a read bar in the toot to indicate that it is there.)
|
|
||||||
|
|
||||||
*Note that the curses UI is not available on Windows.*
|
|
||||||
Loading…
Reference in a new issue