From The Mastodon Wiki
Revision as of 19:06, 13 November 2017 by Gloop (talk | contribs) (Contrast, colours, columns)
Jump to: navigation, search

This is a collection of resources on accessibility issues that may come up while using Mastodon.

Suggestions for new Mastodon features can be made by opening a new issue here. Use the search first to see if something similar has already been discussed.

Image descriptions

Image descriptions for screenreader users are part of Mastodon since version 2.0. See this guide for how to use them.

Not all mobile clients have implemented them. You can tell the maintainer of your client that this feature is important to you. (For example by tooting at them or opening an issue on Github or wherever they keep their code.)

Contrast, colours, columns

Need wider columns? A less busy layout? Dark text on light background? Better contrast? There are a few options.


Halcyon is a web client that makes Mastodon look like Twitter.

That means:

  • One wide column
  • Black text on white background.

It works for all instances, you simply grant it access to your account. | Halcyon on Github


A Mastodon client that is a Chrome/Chromium extension. Multi-account.

Configurable bits:

  • Colours
  • The columns that are shown (you have to open them all individually, then they stay there)
  • Position, width and height of the columns

On the Chrome Store | Kurotodon on Github

Use a custom style

You can use a browser plugin like Stylus to make Mastodon look different.

There are already many styles that have been made available for everyone to use.

How to use them:

  1. Install Stylus
  2. Look for a style that suits your needs on
  3. Does the description say that the style applies to your instance?
    1. Yes? Ignore this step, and ignore step 5.
    2. No? Look for an "Advanced Options" button. Some styles have a box to enter your instance there. If yes, do that. If no, don't worry, step 5 will tell you what to do.
  4. Click "Install Style".
  5. If you already added your instance in step 3, that's it. Skip the next steps.
    1. If you didn't, click on the Stylus icon somewhere to the right of your browser's search bar and then on "Manage". (Or if there is no icon [this is in Firefox, Chrome is probably somewhat similar] click on the burger menu, click on "Add-ons", click on "Extensions", find Stylus, click on its "Preferences", scroll to the bottom and click "Manage Styles".)
    2. Click on the name of the style that you just installed.
    3. Scroll to "Applies to", and click "Add" (next to the last URL box, on the right side).
    4. Enter the address of your instance. Click "Save" (in the column on the left). NOW you're done.

Combining different styles may sometimes make things look weird, but a lot of the time it works, especially if one changes only colours and one only column widths or similar. Just try it and remove any that don't work.

Unpin some columns

If the number of columns is distracting you, you can remove some of them. Only "Getting Started" and the one where you write your toots can't be removed. To do that, click the settings icon on top of a column. At the bottom it says "Unpin". Click that.

To get a column back, open it via Getting Started or via the symbols over the search bar. Open the settings again and click "Pin".

Instance themes

Some instances use their own custom themes. Check UI previews for some screenshots.

Instances can have more than one theme. Check in your settings (in Preferences scroll down to Site theme), and if you don't have a choice there, ask your admin if they'd be willing to add a theme that works for you. Mastodon Light might be an option if you need dark text on light background.

Too many notifications

Click the settings icon in your notification column. There you can choose which types of notification you want to get, or not.

You can toggle sound, desktop notifications and even the notification appearing in the column at all seperately for new followers, favourites, mentions and boosts.