GuideToMastodon

Read this guide to Mastodon, described by its repository as an increasingly less-brief introduction.

github.com/joyeusenoelle/GuideToMastodon
GuideToMastodon homepage screenshot

About GuideToMastodon

GuideToMastodon is a GitHub repository containing a written guide to Mastodon, described by its repository as an increasingly less-brief introduction. The guide explains Mastodon concepts, federation, comparisons to Twitter and email, instance selection, account migration, mentions, rules, moderation, post types, privacy settings, following, muting, blocking, hashtags, content warnings, image captions, custom emoji, search, account backups, and keyboard navigation.

The repository is open source and accepts change requests via GitHub or contact by Mastodon or email. It is a static English-language guide rather than an interactive service, and pricing information is not provided.

Key features

  • Explains Mastodon basics, federation, local and federated timelines, and the Fediverse.
  • Covers choosing an instance, moving accounts, changing usernames, and cross-instance mentions.
  • Describes instance rules, moderation, reporting violations, and handling unwanted interactions.
  • Details post types, privacy settings, locked accounts, muting, blocking, and following.
  • Explains hashtags, content warnings, image captions, custom emoji, and character limits.
  • Addresses account backups, keyboard navigation, and differences from Twitter.
Best for: People new to Mastodon or migrating from Twitter who want a written introduction to its features, culture, and norms.
Good for
  • Open source and accepts contributions via GitHub or email.
  • Marks important differences from Twitter with a ‼️ emoji.
  • Covers a broad set of Mastodon topics in its table of contents.
Watch out for
  • Mastodon features vary by server, so some guide topics may not apply to every instance.
  • Author notes it has been a while since using Twitter and some differences may be missed.
  • It is a static repository guide, not an interactive app or service.

GuideToMastodon at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Open source
Yes · Source code
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

GuideToMastodon alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

phanpy

github.com/cheeaun/phanpy

Access Mastodon through Phanpy, a minimalistic web client described by its project repository.

Open source
24 alternatives

instances

github.com/TheKinrar/instances

This repository contains the source code for a directory of Mastodon instances, helping users browse available servers.

Open source
24 alternatives

Popular in Fediverse

Well-known listings from the same topic.

All 113

GuideToMastodon FAQ

What is Mastodon?
Mastodon is a social networking software platform that allows someone to run their own social media site and lets each Mastodon site talk to other Mastodon sites and many others. It is described as a cross between Twitter and email.
How is Mastodon like Twitter?
You post relatively-short status updates, see a streaming list of friends' updates, and keep notifications in a separate column. Statuses are called toots and can be up to 500 characters or more depending on server settings. Hashtags are supported.
How is Mastodon like email?
Each Mastodon instance is independent but networked like email servers. Signing up on one instance does not create accounts on others, but you can talk to users from other instances.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing