From Wikitech
Jump to navigation Jump to search
Toolforge tools
Description collaboratively draft and publish Mastodon posts
Keywords mastodon, fediverse
Author(s) (Legoktmtalk)
Maintainer(s) Legoktm, TheresNoTime (View all)
Source code
License GNU Affero General Public License 3.0 or later
Issues Open tasks · Report a bug

masto-collab allows for drafting Mastodon posts using wikis as a collaboration platform. There are two primary goals: 1) leverage wikis as a platform for collaboration and 2) use wiki accounts as a way to provide delegated access to Mastodon accounts.


All state is stored on wikis, the tool merely provides views onto the data stored there. It parses the special {{Mastodon post}} template, which should be straightforward to copy to other wikis. This ensures a transparent audit trail through wiki edits for who took what actions. We also get to use wiki watchlists, enotifs and RSS feeds instead of having to re-implement a notification mechanism. And of course, because this is on public wiki pages, anyone can edit/improve your post before it's published.

Authentication is done over wiki OAuth, the tool has a list of "authorized users" per account and a Mastodon OAuth token. This allows us to delegate posting access by wiki account without needing to share the password for the Mastodon account.


On the Mastodon side, the masto-collab tool only needs access to the read:statuses, write:statuses and write:media scopes. This and the list of approved users are stored in a private configuration file that is only accessible by the tool maintainers and Toolforge admins. If you don't trust those people, you can always host your own instance of the tool elsewhere.