awesome-mastodon/README.md

# Awesome Mastodon [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome) [![License: CC0](https://img.shields.io/badge/License-CC0-lightgrey.svg)](https://creativecommons.org/publicdomain/zero/1.0/)

[<img src="https://rawgit.com/tleb/awesome-mastodon/master/mastodon-logo.svg" align="right" width="150">](https://joinmastodon.org)

> Curated list of Mastodon-related stuff!

**Mastodon is the world's largest free, open-source, decentralized microblogging network**. See the [Official](#official) and [Documentation](#documentation) categories to learn more about the network.

## Contents

* [Official](#official)
* [Documentation](#documentation)
* [Clients](#clients)
* [Federated servers](#federated-servers)
* [Tools](#tools)
* [User styles](#user-styles)
* [User scripts](#user-scripts)
* [Bots](#bots)
* [News & magazines bots](#news--magazines-bots)
* [Associations](#associatons)
* [Blogs](#blogs)
* [Libraries](#libraries)
* [Hosting](#hosting)

## Official

* [Website](https://joinmastodon.org)
* [GitHub repository](https://github.com/tootsuite/mastodon)
* [Documentation & official explaination](https://docs.joinmastodon.org/)

## Documentation

* [What I wish I knew before joining Mastodon](https://hackernoon.com/what-i-wish-i-knew-before-joining-mastodon-7a17e7f12a2b) - Introduction to Mastodon.
* [Wiki](https://en.mstdn.wiki/Main_Page) - Mastodon Community Wiki.
* [API documentation](https://docs.joinmastodon.org/client/intro/)

## Clients

* [Tusky](https://play.google.com/store/apps/details?id=com.keylesspalace.tusky) - Android client.
* [Twidere](https://f-droid.org/packages/org.mariotaku.twidere/) - Android app for Twitter, GNU Social and Mastodon.
* [Tooty](https://github.com/n1k0/tooty) - Experimental multi-account Mastodon Web client (Elm).
* [toot](https://github.com/ihabunek/toot) - Mastodon CLI client (Python).
* [madonctl](https://github.com/McKael/madonctl) - Mastodon CLI client (Go).
* [naumanni](https://github.com/naumanni/naumanni) - Web user interface specially designed for Mastodon.
* [Tooter](https://github.com/dysk0/harbour-tooter) - Native client for SailfishOS.
* [Fedilab](https://framagit.org/tom79/fedilab) - Android client.
* [Pinafore](https://github.com/nolanlawson/pinafore) - Alternative web client for Mastodon, focused on speed and simplicity.
* [Brutaldon](https://github.com/jfmcbrayer/brutaldon) - Brutaldon is a brutalist, Web 1.0 web interface for Mastodon.
* [Halcyon](https://notabug.org/halcyon-suite/halcyon) - Alternative web client for Mastodon and Pleroma with a Twitter-like interface.
* [Whalebird](https://whalebird.social/en/desktop/contents) - Electron-based Mastodon client.
* [Planiverse](https://git.mulligrubs.me/planiverse/) - Minimalist, no-JS Web client for Mastodon.
* [Toot!](https://apps.apple.com/us/app/toot/id1229021451) - Mastodon client for iOS.

## Federated servers

* [Mastodon](https://joinmastodon.org/) - Most known microblogging platform.
* [Pleroma](https://pleroma.social/) - Lightweight microblogging platform.
* [GnuSocial](https://gnu.io/social/) - Oldest microblogging platform.
* [Microblog.pub](https://microblog.pub/) - Single-user lightweight microblogging platform.
* [Hubzilla](https://zotlabs.org/page/hubzilla/hubzilla-project) - Blog/social networks platform with file, contacts and events sharing.
* [Friendica](https://friendi.ca/) - Social network platform.
* [Peertube](https://joinpeertube.org/) - Video sharing platform.
* [FunkWhale](https://funkwhale.audio/) - Audio sharing platform.
* [Plume](https://joinplu.me/) - Blogging platform.
* [WriteFreely](https://writefreely.org/) - Blogging platform.
* [Prismo](https://gitlab.com/prismosuite/prismo) - Link aggregation platform.
* [PixelFed](https://pixelfed.org/) - Photograph sharing platform.
* [NextCloud Social](https://apps.nextcloud.com/apps/social) - Microblogging inside the cloud platform.

## Tools

* [Mastodon instances](https://instances.social/list) - List of Mastodon instances.
* [unmung.com/mastoview](http://www.unmung.com/mastoview) - Preview the local or federated timeline of any instance.
* [Toot scheduler](https://scheduler.mastodon.tools/) - Schedule now, toot later.
* [Mastodon Network Monitoring (MNM)](https://dashboards.mnm.social/) - Track and display browsable stats about the Mastodon network.
* [Last](https://framagit.org/luc/last) - Aggregate toots on a web page providing Atom feed and an epub (Perl).
* [Forget](https://forget.codl.fr/about/) - Delete toots after a user defined period of time (Python [source code](https://github.com/codl/forget/)).
* [Mastodon Toot Bookmarklet](https://rmlewisuk.github.io/mastodon-toot-bookmarklet/) - Bookmarklet to toot the current page ([source code](https://github.com/rmlewisuk/mastodon-toot-bookmarklet/))
* [Mastodon – Simplified Federation!](https://addons.mozilla.org/firefox/addon/mastodon-simplified-federation/?src=external-github-awesomelist) - Redirect clicks on remote follow/interaction buttons to your own instance ([source code](https://github.com/rugk/mastodon-simplified-federation)).
* [Mastodon Explorer](https://mastodon-explorer.netlify.com/) - Trending hashtags and popular toots, regenerated every hour.

## User styles

* [Variable width](https://userstyles.org/styles/139721/mastodon-glitch-soc-variable-width) - Makes Mastodon scale with the browser's width.
* [Narrow drawer](https://userstyles.org/styles/141457/mastodon-dynamic-wide-columns-narrow-drawer) - With the variable width style, makes the drawer narrower and the other columns scale accordingly.

## User scripts

* [NSFW Remover](https://greasyfork.org/fr/scripts/29228-mastodon-nsfw-remover) - Automatically display NSFW images.
* [Customizable interface](https://openuserjs.org/scripts/bl00m/Mastodon_Customizable_Interface) - Move and resize columns on a grid.
* [BirdSite](https://gitlab.com/pmorinerie/birdsite) - Browser extension for cross-posting Mastodon toots to Twitter.

## Bots

* [feed2toot](https://gitlab.com/chaica/feed2toot) - Automatically parses RSS feeds, identifies new posts and posts them on Mastodon (Python).
* [usercount](https://github.com/josefkenny/usercount) - Bot which posts user statistics to Mastodon (Python).
* [autofollow](https://github.com/gled-rs/mastodon-autofollow) - Autofollow bot for Mastodon (Python).
* [hnbot](https://github.com/raymestalez/mastodon-hnbot) - Posts the Hacker News stories with 100+ points (Python).
* [translator](https://christopher.su/projects/translator/) - Translate any toot into the desired language using `@translator@toot.works [langcode]`.
* [@TrendingBot@mastodon.social](https://mastodon.social/@TrendingBot) - Shows you what's trending on Mastodon.
* [Remindr](https://gitlab.com/chaica/remindr) - Automatically send reminders to both Mastodon and Twitter from a list of resources (Python).
* [News Bot](https://botsin.space/@newsbot) - mirrors Twitter accounts on Mastodon (ClojureScript), source available on [GitHub](https://github.com/yogthos/mastodon-bot).
* [Welcome Bot](https://github.com/indyhall/mastodon-welcome-bot) - Automatically send a welcome DM to new users (Python).

## News & magazines bots

Please note: most of them are non-official. Also, we do not *recommend* any, they are just listed here for your information.

### English

* [@fsf@status.fsf.org](https://status.fsf.org/fsf) - FSF Free Software Foundation.
* [@HackerNewsBot@mastodon.social](https://mastodon.social/@HackerNewsBot) - Hacker News.
* [@newsstream@quitter.im](https://quitter.im/newsstream) - NewsStream.
* [@btc@framapiaf.org](https://framapiaf.org/@btc) - News about the Bitcoin Cryptocurrency (marketcap, community, rise/drop alerts).
* [@ethereum@framapiaf.org](https://framapiaf.org/@ethereum) - News about the Ethereum Cryptocurrency (marketcap, community, rise/drop alerts).
* [@monero@framapiaf.org](https://framapiaf.org/@monero) - News about the Monero Cryptocurrency (marketcap, community, rise/drop alerts).
* [@launchradar@mastodon.cloud](https://mastodon.cloud/@launchradar) - News about space flight, astronomy and astrophysics.

### Français

* [@BFMTV@mastodon.social](https://mastodon.social/@BFMTV) - BFMTV.
* [@courrierinter@mastodon.xyz](https://mastodon.xyz/@courrierinter) - Courrier international.
* [@artefr@mamot.fr](https://mamot.fr/@artefr) - Arte.
* [@datagueule@framapiaf.org](https://framapiaf.org/@datagueule) - DATA Gueule.
* [@lemondebot@mastodon.xyz](https://mastodon.xyz/@lemondebot) - Le Monde.
* [@libe@mamot.fr](https://mamot.fr/@libe) - Libération.
* [@lecanardenchaine@mamot.fr](https://mamot.fr/@lecanardenchaine) - Le Canard Enchaîné.
* [@lefigaro@mastodon.xyz](https://mastodon.xyz/@lefigaro) - Le Figaro.
* [@lesjoursfr@mamot.fr](https://mamot.fr/@lesjoursfr) - Les Jours.
* [@mdiplo@mamot.fr](https://mamot.fr/@mdiplo) - Le Monde Diplomatique.
* [@Mediapart@mastodon.social](https://mastodon.social/@Mediapart) - Mediapart officiel (non actif).
* [@mediapartbot@mastodon.xyz](https://mastodon.xyz/@mediapartbot) - Mediapart bot actif.
* [@NextInpact@mamot.fr](https://mamot.fr/@NextInpact) - NextInpact.
* [@reflets@mastodon.social](https://mastodon.social/@reflets) - Reflets.info.
* [@TV5Monde@mamot.fr](https://mamot.fr/@TV5Monde) - TV5 Monde.

## Associations

### English

* [@torproject@mastodon.social](https://mastodon.social/@torproject) - Tor Project.

### Français

* [@aprilorg@pouet.april.org](https://pouet.april.org/@aprilorg) - APRIL.
* [@Attac@mamot.fr](https://mamot.fr/@Attac) - Attac France.
* [@acrimed@mamot.fr](https://mamot.fr/@acrimed) - Acrimed.
* [@framasoft@framapiaf.org](https://framapiaf.org/@Framasoft) - Framasoft.
* [@LaQuadrature@mamot.fr](https://mamot.fr/@LaQuadrature) - La Quadrature du Net.

## Blogs

### English

### Français

* [@FossoyeurDeFilms@friends.nico](https://friends.nico/@FossoyeurdeFilms) - Fossoyeur de Films.
* [@HygieneMentale@oc.todon.fr](https://oc.todon.fr/@HygieneMentale) - Hygiène Mentale.
* [@journalduhacker@framapiaf.org](https://framapiaf.org/@journalduhacker) - Journal du Hacker.
* [@korbenbot@mastodon.xyz](https://mastodon.xyz/@korbenbot) - Korben (bot).
* [@MinutePapillon@friends.nico](https://friends.nico/@MinutePapillon) - Kriss / Minute Papillon.

## Libraries

* [Mastodon.py](https://github.com/halcy/Mastodon.py) - Python wrapper for the Mastodon API.
* [Megalodon](https://github.com/h3poteto/megalodon) - Mastodon API client library for node.js.

## Hosting

* [Masto.host](https://masto.host) - Fully managed Mastodon hosting.