Tooting with mastodon.el
========================

Mastodon.el is an Emacs mode to access ActivityPub instances.

Follow your home timeline, the local timeline, and the federated
timeline all from within the comfort of your Emacs session.

Many options
------------
Just like any other ActivityPub client, Mastodon.el supports many options.

Some examples:
* Follow the standard timelines
* Follow the timeline of one or more tags
* Compose and send a toot
* Boost and favorite posts
* Bookmark posts
* View and update your profile
* View profiles of other ActivityPub users
* Search posts
* And more

Installation
------------
Add the following lines to your Emacs init file to install mastodon.el
with use-package:

  (use-package mastodon
    :ensure t
    :config
    (setq mastodon-instance-url "<url-of-your-instance>")
    (setq mastodon-active-user "<username>"))

Evaluate the buffer with the init file or restart Emacs.

Next, open the `*Messages*'-buffer in a second window.
Run `M-x mastodon', this will add an extremely long URL to your messages
and prompts for an authorization code in the mini-buffer.

Copy the URL from the `*Messages*'-buffer and open it in your browser
(I used Firefox for this). You will get a code, copy this and paste
it in the mini-buffer.

You are now all set.

Tooting and some other useful keys
----------------------------------
Just hit `t' to compose a toot, and when ready, send it with the well
known key combo `C-c C-c', or cancel it with `C-c C-k'.
Change the toot visibility with `C-c C-v', and add a content warning
with `C-c C-w'.

Keys to open timelines:
* `H' : Open your home timeline
* `F' : Open federated timeline
* `L' : Open local timeline

Some other useful keys:
* `#' : Prompts you for a tag and open the timeline of the tag.
* `u' : Update the current timeline
* `b' : Boost toot under point
* `f' : Favorite toot under point
* `k' : Toggle bookmark of toot under point

For (much) more, see the info-file that comes with the package
or the mastodon.el homepage at:
https://codeberg.org/martianh/mastodon.el

Happy tooting!


Last edited: $Date: 2024/04/14 16:13:00 $