# 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/) [](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) * [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) * [Frequently Asked Questions](https://github.com/tootsuite/documentation/blob/master/Using-Mastodon/FAQ.md) ## 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 overview](https://github.com/tootsuite/documentation/blob/master/Using-the-API/API.md) ## 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. * [Tootdon](http://tootdon.club) - Fully featured client for iOS and Android. * [Mastalab](https://github.com/stom79/mastalab) - 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. ## Tools * [Mastodon instances](https://instances.social/list) - List of Mastodon instances. * [Mastodon bridge](https://bridge.joinmastodon.org/) - Find your Twitter friends in the federated Mastodon network. * [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). * [Mastodon Tags Explorer](https://mastodon-tags-explorer.hcxp.co/tags) - Explore what's currently trending in Mastodon network. * [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/)) * [Blubbll's mastodon repo](https://github.com/blubbll/mastodon/) - Random node.js script for custom, extended usage of the Mastodon (API) flow ## User styles * [Variable width](https://userstyles.org/styles/139721/mastodon-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. * [@nasa@apoil.org](https://apoil.org/@nasa) - NASA. * [@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. * [@le_gorafi@apoil.org](https://apoil.org/@le_gorafi) - Le Gorafi. * [@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 * [@epenser@apoil.org](https://apoil.org/@epenser) - Bruce Benamran / e-penser. * [@commitstrip@framapiaf.org](https://framapiaf.org/@commitstrip) - Commitstrip.fr. * [@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. ## Hosting * [Masto.host](https://masto.host) - Fully managed Mastodon hosting.