A curated list of developer resources related to ActivityPub and the Fediverse.
Find a file
2023-11-10 06:09:17 +00:00
delightful-contributors.md Add SevicheCC to comtributors 2023-06-08 08:11:28 +00:00
LICENSE Migrate Feneas wiki page to Codeberg delightful list 2022-01-13 19:25:24 +01:00
README.md Add FediKit 2023-11-10 06:09:17 +00:00

delightful activitypub development delightful

A curated list of resources for ActivityPub developers who create software for the Fediverse.

Contents

Developer tools

Frameworks

  • Bonfire: An extensible framework with a big focus on customisation and flexibility. Can be used to build new federated apps while focusing on a specific use case rather than reimplementing lots of boilerplate AGPL-3.0, Elixir

Libraries

  • ActivityPhp (site, Fedi account): A PHP implementation of ActivityPub protocol based upon the ActivityStreams 2.0 data format. MIT, PHP

  • ActivityPods: Adding intelligence to Solid PODs with ActivityPub (based on SemApps. Apache-2.0, Javascript

  • ActivityPub: Generic library to federate an app with ActivityPub (uses a queue for incoming/outgoing activities and adapter modules for tight integration). AGPL-3.0, Elixir

  • activityPub-core: An attempt to build a spec-compliant ActivityPub core library. MIT, Typescript

  • ActivityPub Express: Modular ActivityPub implementation as Express.js middleware to easily add decentralization and federation to Node apps MIT, Javascript

  • ActivityPub-Federation: A high-level framework for ActivityPub federation in Rust, extracted from Lemmy. AGPL-3.0, Rust

  • :heavy_check_mark ActivityPub Models - "ActivityPub JS/TS models with docs TypeScript, -

  • ActivityPub HTTP Signatures (Fedi account): A library for creating, parsing, and verifying HTTP signature headers, as per the Signing HTTP Messages draft 80 specification. ISC, Javascript

  • ActivityPub-PHP (Fedi account): A PHP implementation of the ActivityPub protocol (used in Pterotype plugin). MIT, PHP

  • ActivityPub Starter Kit: A tiny, single user ActivityPub server, meant to be a starting point for your own ActivityPub projects. MIT, Typescript

  • activityPub4j: W3C ActivityPub and ActivityStreams implementation in Java using Spring Boot. Apache-2.0, Java

  • ActivityHub.Net: A C# .NET Implementation of ActivityPub Entity Types. -, C#

  • ActivityPub.Net: A parser for ActivityPub. MIT, C#

  • ActivityServe: A very light ActivityPub library in Go (used to power pherephone) MIT, Go

  • ActivityStream (Fedi account): Simple ActivityStream handling for Go. Apache-2.0, Go

  • ActivityStreams (Fedi account): A set of Traits and Types that make up the ActivityStreams and ActivityPub specifications. GPL-3.0, Rust

  • ActivityStreams: Full ActivityStreams 1.0 and 2.0 reference implementation in Java. Apache-2.0, Java

  • ActivityStreams: A .NET implementation of the Activity Streams vocabulary in the form of classes that can be serialized using System.Text.Json MIT, C#

  • ActivityStreams-2: ActivityStreams 2.0 library for Node.js and TypeScript. Apache-2.0, Typescript

  • astreams (Fedi account): A hand-crafted implementation of the Activity Streams 2.0 specification in Go, especially suitable for projects implementing ActivityPub. AGPL-3.0, Go

  • atoot: Library providing an easy way to create Mastodon API applications MIT, Python

  • Clovis: [ARCHIVED] Implementation of ActivityPub in Scala. (Hobby project included here for reference only.) AGPL-3.0, Scala

  • Bovine (PyPI, ReadTheDocs, Fedi account): Basic Python FediVerse utility library. MIT, Python

  • Chatter Net Client: A decentralized semantic web built atop self-sovereign identity. Client-side. MIT, Typescript

  • Chatter Net Server: A decentralized semantic web built atop self-sovereign identity. Server-side. MIT, Rust

  • corpus-activity-streams: Activity Streams 2.0 vocabulary data and alternative docs. Unlicense license, Typescript

  • DarkLink.Web.ActivityPub: A framework (kinda) to work with ActivityPub with .NET MIT, C#

Dialtone: An "un-imagined" ActivityPub service, to address emergent use cases. Multi-tenant, multi-personality, multi-ownership. Apache-2.0 / MIT, Rust

  • Digit: Simple API for building WebFinger resource responses. Apache-2.0, Go

  • Disboard: Collection of fediverse API wrapper libraries for .NET Standard 2.0. MIT, C#

  • Drastic.Mastodon: A fork of Masto.NET, a C#/.NET Library for accessing Mastodon. MIT, C#

  • Express ActivityPub: A very simple reference implementation of an ActivityPub server using Express.js. MIT, Javascript

  • Federails: An ActivityPub engine for Ruby on Rails. MIT, Ruby

  • Federation: Library to abstract social web federation protocols like ActivityPub, Diaspora and Matrix (see docs) BSD-3-clause, Python

  • FediKit: Building Blocks for Fediverse. MIT, TypeScript

  • fedi-inbox (Fedi account): Basic Fediverse Inbox. Writing software is hard and time consuming. What's the most basic practical system that lets us connect to the fediverse? -, Javascript

  • fuwuqi (Fedi account): A useless C2S ActivityPub server for "extremely hardcore" ActivityPub enthusiasts. GPL-3.0, Python

  • Golang ActivityPub (Fedi account): Libraries for using ActivityPub in the Go language. MIT, Go

  • go-fed activity (site, Fedi account): Full ActivityStreams & ActivityPub implementation in Golang. Extensions can be easily added by design-time code generation from JSON-LD schema's (also supports ForgeFed this way, by default). BSD-3-clause, Go

  • go-fed apcore (site, Fedi account): A powerful single server ActivityPub framework for performant Fediverse applications. AGPL-3.0, Go

  • go-mastodon: Mastodon client for Golang. MIT, Go

  • Hannibal: ActivityPub library for Golang. Apache-2.0, Go

  • hare-activity (Fedi account): Hare package provides a extensible implementation of the ActivityStreams 2.0 format and the ActivityPub protocols. MPL, Hare

  • http-signature: Implementation of the HTTP Signature scheme as used in ActivityPub. Apache-2.0, Typescript

  • Incognitum: A .NET Standard library for Mastodon. MIT, C#

  • Little Boxes: Tiny ActivityPub framework, both database and server agnostic ISC, Python

  • Little Library: A digital give-a-book, take-a-book library for ebooks AGPL-3.0, Javascript

  • Mastodon.py: Python wrapper for the Mastodon API. MIT, Python

  • Masto.Net: A C# Library for Mastodon. MIT, C#

  • Megalodon: Mastodon, Pleroma and Misskey API client library for node.js and browser. MIT, Typescript

  • Megalodon-rs: Mastodon and Pleroma API client library for Rust. Apache-2.0, Rust

  • Mod.ActivityPub: ActivityPub Server services for ASP.NET -, C#

  • Pub: A tiny ActivityPub to Mastodon bridge. BSD-3-Clause, Go

  • Pubstrate: ActivityStreams and ActivityPub library implementation for GNU Guile. Includes a full ActivityStreams library and most of an ActivityPub implementation. GPL-3.0, Guile

  • pynodeinfo: NodeInfo library implemented with poetry. AGPL-3.0, Python

  • Python ActivityPub: A general ActivityPub library MPL-2.0, Python

  • rdf-pub (site, Fedi account): An activity-pub server implementation, that is not limited to the activity-stream vocabulary, but supports RDF per se. EUPL, Java

  • Sigh (Fedi account): HTTP signatures for ActivityPub in Rust. MIT, Rust

  • The Old Dog and Duck: A Clojure library designed to implement the ActivityPub protocol. GPL-2.0, Clojure

Plugins

Relays

  • ActivityRelay: A generic LitePub relay (works with all LitePub consumers and Mastodon). AGPL-3.0, Python

  • activity-relay: Yet another powerful customizable ActivityPub relay server written in Go AGPL-3.0, Go

  • Hash2Pub (Fedi account): A fully-decentralised DHT-based relay for global hashtag federation. See White paper, status update (Nov 2020) AGPL-3.0, Haskell

  • Pub-Relay (Fedi account): A service-type ActivityPub actor that will re-broadcast anything sent to it to anyone who subscribes to it. AGPL-3.0, Crystal

  • Seattle relay -, Python

  • Social relay: Public post relay for the diaspora* federated social network protocol. AGPL-3.0, Python

  • toot-relay: Relay that forwards web push notifications to APNs, built for Toot!.app but usable for anyone. CC0, Go

  • AodeRelay: A simple and efficient ActivityPub relay. AGPL-3.0, Rust

For an overview of known relays, see Relay List, a regularly updated, sorted list of ActivityPub relays for Mastodon or Pleroma.

Bridges

  • bird.makeup (Fedi account) A Twitter bridge to the Fediverse. Forked from BirdSiteLIVE. AGPL-3.0, C#

  • BirdSiteLIVE (Fedi account): An ethical bridge from Twitter AGPL-3.0, C#

  • bleroma: Telegram bot for Pleroma and Mastodon. MIT, Elixir

  • Bridgy Fed (site, Fedi account): Bridges the IndieWeb to federated social networks: ActivityPub, OStatus, etc. Public Domain, Python

  • Fediverse-Action: Github Action that posts to Fediverse when code is changed. ISC License, Javascript

  • Toot-Together (Fedi account): Github Action that posts to Mastodon from text files, enabling everyone to submit toot drafts to a project. MIT, Javascript

  • feedToMasto: Node app that checks a list of feeds (Atom, RSS, RDF) periodically, post new items to Mastodon. ISC, Javascript

  • feed2toot: Parses RSS feeds, identifies new posts and posts them on the Mastodon social network (using the Mastodon API). MIT, Python

  • feediverse: Send RSS/Atom feeds to Mastodon. MIT, Python

  • gemifedi: A Gemini frontend to the fediverse (specifically, Mastodon and Pleroma instances). AGPL-3.0, Rust

  • ghostcms-activitypub: An ExpressJS server that integrates with GhostCMS webhooks to publish ActivityPub content on the Fediverse. MIT, JavaScript

  • Hatsu: Self-hosted & Fully-automated ActivityPub Bridge for Static Sites. AGPL-3.0, Rust

  • Instagram2Fedi: Script for crossposting from Instagram to Mastodon or Pixelfed. GPL-3.0, Python

  • Kazarma: A Matrix bridge to ActivityPub. AGPL-3.0, Elixir

  • Libervia (site, Fedi account): An XMPP <=> ActivityPub gateway project doubled with XMPP Pubsub end-to-end encryption AGPL-3.0, Python

  • ligh7hau5: A Matrix to Fediverse / ActivityPub client / bridge. Also, some media proxying. GPL-3.0, Javascript

  • mastodon-bot: a bot for mirroring Twitter / Tumblr accounts and RSS feeds on Mastodon MIT, Clojure

  • mastodon-twitter-poster (site, Fedi account): Crossposter to post statuses between Mastodon and Twitter. AGPL-3.0, Ruby

  • mastotuit (Fedi account): Publishes to Twitter all your Mastodon public text only posts but also your posts with images, with videos and even your polls. GPL-3.0, Python

  • Moa (site): A Mastodon, Twitter, and Instagram Cross-poster. MIT, Python

  • Mobilizon Crossposter: A modular crossposter to bridge events from sources you have to setup yourself to Mobilizon. GPL-3.0, Python

  • MXToot (Fedi account): A Matrix <--> Mastodon bot written in Java. Apache-2.0, Java

  • Nautilus: A standalone service to deliver posts from your own website to ActivityPub followers. Apache-2.0, PHP

  • PeerTube (on Matrix) Search: Search PeerTube via Matrix, using Sepia Search API to search on all participating public PeerTube instances. You can also select any single instance. It's implemented as a module for Hemppa the bot. GPL-3.0, Python

  • pleroma-bot: Mirrors Twitter accounts to Fediverse, or migrates Twitter account to Fediverse using a Twitter archive. Supports Mastodon, Pleroma and Misskey. MIT, Python

  • Pubgate Telegram: Extension for PubGate, federates Telegram channels and back. BSD-3-Clause, Python

  • rss-bot (Fedi account): Post updates from an RSS feed to Mastodon. GPL-3.0, Python

  • RSS-to-ActivityPub Converter: Convert any RSS feed to an ActivityPub actor that can be followed by users on ActivityPub-compliant social networks like Mastodon. MIT, Javascript

  • RSS-Bridge ActivityPub Bridge (site, Fedi account): Generates RSS and Atom feeds for websites that don't have one. Supports Mastodon, Pleroma and Misskey, among others. Unlicense, PHP

  • ✔️Simplebot-Mastodon: A Mastodon - DeltaChat bridge plugin for SimpleBot, list of bot instances MPL-2.0, Python

  • Twitter Hamachpil (Fedi account): Bot to grab tweets from Twitter and post them to respective accounts on a Mastodon instance. Apache-2.0, Python

  • YouTube2PeerTube: A bot that mirrors YouTube channels to PeerTube channels as videos are released in a YouTube channel. AGPL-3.0, Python

  • Raycast Extension for Akkoma (site): By @Seviche CC, Publish status from Raycast to Akkoma or Pleroma, and view your bookmarked status MIT, TypeScript

Utilities

  • ActivityPubBotDotNet (Fedi account): An implementation of a ActivityPub bot that can communicate with Mastodon servers. MIT, C#

  • ActivityPubSchema: JSON Schema definition of the ActivityStreams and ActivityPub specifications. MIT, Javascript

  • ActivityPub Pelican Plugin: Experimental ActivityPub plugin for Pelican static site generator. ISC, Python

  • activity-streams-validator (Fedi account): Activity Streams validation for Typescript. MIT, Typescript

  • AP follow - A remote follow tool to share links and buttons that allow people to follow you from their own ActivityPub instance BSD-2-clause, PHP

  • bridge: A simple web app that helps you find your Twitter friends on the federated Mastodon network. It is also an example of how the Mastodon API can be used and the federated OAuth authorization flow. AGPL-3.0, Ruby

  • dda-masto-embed (Fedi account): Embeds mastodon timline into a html page. Uses JS, no intermediate server required. Apache-2.0, ClojureScript

  • emfed (Fedi account): Embed your Mastodon feed into your web page. Unlicense, Typescript

  • f2ap: A web application that uses the RSS/Atom feed of your website to expose it on the Fediverse through ActivityPub. AGPL-3.0, Python

  • FediAct: Chrome/Firefox extension that simplifies interactions on other Mastodon instances than your own. MIT, Javascript

  • fediblock-importer: Import domain blocks to your Mastodon v4+ instance. GPL-3.0, Python

  • FediCraft: Federated network support for Minecraft. (fabric and quilt). MIT / Apache-2.0, Java

  • FediFetcher for Mastodon (site): Automatically fetch missing replies and posts from other fediverse instances. MIT, Python

  • Fedifinder - Find fediverse addresses in the profiles of your Twitter followings MIT, Javascript

  • fediverse.space (Fedi account, site): A tool to visualize instances in the fediverse. AGPL-3.0, Elixir

  • Fediverse Stats (Fedi account): Collects maximum number of alive fediverse's servers and then query their API to obtain their registered users. GPL-3.0, Python

  • Followgraph (site, Fedi account): A tol to expand your connection graph and find new people to follow. (Unlicensed, see open issue) -, Typescript

  • forget (site, Fedi account): Continuous post deletion for Mastodon and Twitter (if you happen to use that). ISC License, Python

  • Granary (site): The social web translator. Fetches and converts data between social networks, HTML and JSON with microformats2, ActivityStreams, Atom, JSON Feed, and more. Public domain, Python

  • hunter2 (site, Fedi account): A job hunt bot that indexes jobs and candidates from the Fediverse. MIT, Rust

  • MaPleFeed (site, Fedi account): Embed Mastodon or Pleroma profile feeds on any web page. MIT, Javascript

  • MastoBot (Fedi account): NodeJS Mastodon client library with an eye to making bot development fun & easy. ISC License, Javascript

  • Mastodon Archive:Archive your statuses, favorites and media using the Mastodon API. GPL-3.0, Python

  • mastodon-backup (Fedi account): Archive your statuses, favorites and media using the Mastodon API. GPL-3.0, Python

  • Mastodon Backup Resore: Bash scripts for backup / restore of Mastodon. MIT, Shell

  • Mastodon Bird UI: Alternative stylesheet to make Mastodon UI represent the Birdsite. MIT, CSS

  • mastodon_bulk_find_follow (site): Bulk find and follow to make it easy to migrate from Twitter to Mastodon. BSD-3-Clause, Javascript

  • mastodon_digest (Fedi account): A script that aggregates recent popular posts from your Mastodon timeline. BSD-3-Clause, Python

  • MastodonKit (site): A Swift Framework that wraps Mastodon's API. MIT, Swift

  • mastodon_recommender: Script that recommends people for you to follow on Mastodon based on your own account. -, Python

  • Masto Follow (site, Fedi account): Simple widget to support “Follow Me on Mastodon” buttons ISC License, Javascript

  • MastoMods (Fedi account): CSS tweaks and custom themes for Mastodon. Unlicense, CSS

  • Masto Thread Renderer (site, Fedi account): Display a Mastodon thread (only author toots, no replies) as a web page or Markdown for reading. Apache-2.0, Rust

  • Mastotool: A collection of tools to work with your Mastodon account; displays account statistics and lets you search your toots. MIT, Go

  • Minoru's Fediverse Crawler (site, Fedi account): Crawls the Fediverse and produces a list of instances that are alive. AGPL-3.0, Rust

  • Moderator Alerts (Fedi account): Mastodon moderation alerts using Pushover.net. -, Python

  • M-OAuth(site) (Fedi account): Access token generator for Akkoma, Pleroma, Mastodon APIs. GPL-3.0, TypeScript

  • OCR Bot (Fedi account): An OCR (Optical Character Recognition) bot for Mastodon (and compatible) instances AGPL-3.0, Python

  • Pherephone: An ActivityPub server that reblogs all the statuses of certain actors. You set it up to follow a few accounts and it announces everything they post. AGPL-3.0, Go

  • PocketToots:A Firefox extension that saves your Mastodon bookmarks to Pocket. GPL-3.0, Javascript

  • RapidBlock (site): A tool for syndicating domain blocks across the Fediverse. BSD2-Clause, Go

  • rtoot (Fedi account, site): R package to interact with the mastodon API. MIT, R

  • Shareon (site, Fedi account): Lightweight, stylish, and ethical share buttons. MIT, Javascript

  • Steampipe Mastodon Plugin: Use SQL to instantly query Mastodon timelines and more. Open source CLI to Steampipe SaaS. No DB required. Apache-2.0, Go

  • Steampipe Mastodon Insights Mod: View Mastodon timelines, search hashtags, find interesting people, and check server stats. Apache-2.0, SourcePawn

  • StreetPass (site): A browser extension that helps you find people on Mastodon. MIT, Typescript

  • tags-pub: Provides hashtag objects on the ActivityPub network. Apache-2.0, Javascript

  • toot (site, Fedi account): Cross-instance share page for Mastodon AGPL-3.0, Javascript

  • TootSDK: Cross-platform Swift library for the Mastodon API. BSD-3-Clause, Swift

  • toot-volute: An interpreter for Mastodon posts. GPL-3.0, Javascript

  • Twitodon (site) - Twitter to Mastodon account mapping service to aid migration away from Twitter without losing all your followed friends - , Javascript

  • yt2pt: A simple set of scripts to quickly import your youtube channel to Peertube. MIT, Javascript

  • WebAP Browser Extension: This is a browser extension that implements the WebAP API (still an idea), exposing it to web applications. MIT, Typescript

Testing

  • activitypub-mock: A mock ActivityPub server to use in testing code Apache-2.0, Javascript

  • APDebug (Fedi account): A set of tools to debug ActivityPub requests. You can inspect requests, see the flow in real time, run arbitrary requests with HTTP signature handled for you. AGPL-3.0, PHP

  • dfk-ap (site): A small ActivityPub debugging server on Glitch MIT, Javascript

  • FediDB (site, Fedi account): A suite of tools for AP devs to help make it easier to test and validate your implementation with existing implementations like Mastodon, PeerTube, Pixelfed and Pleroma AGPL-3.0, PHP

  • Test Suite: An unofficial partially-automated ActivityPub test suite AGPL-3.0, Go

Forge federation

This category is dedicated to an important new direction on the Fediverse, where Software Development itself becomes federated. Currently the focus is on projects and protocols that allow for the federation of code forges (such as Gitea and Gitlab).

Forge libraries

  • gofff (Fedi account): Reference implementation of Friendly Forge Format in Golang. AGPL-3.0, Go

  • pyfff (Fedi account): Reference implementation of Friendly Forge Format in Python. AGPL-3.0, Python

Forge tools

  • ForgeFlux StarChart: Software forge spider. Crawler that maps and advertises self-hosted code forge instances. AGPL-3.0, Rust

  • giteacat: Python script that allows sign up to a Gitea instance to all local users of a Mastodon server. -, Python

Forge plugins

Forge federation protocols

Miscellaneous projects

This category is for any code project related to the Fediverse. They need not be directly development related.

  • Sepia Search (site): A search engine of PeerTube videos and channels Developed by Framasoft AGPL-3.0, Typescript

Social sharing

  • Share Buttons: Share buttons that support dynamic input of Fediverse URLs and require no Javascript. AGPL-3,0, PHP

  • Fedishare: Firefox toolbar extension to share the current browser tab on the Fediverse GPL-3.0, Typescript

Other projects

  • Mastodon Simplified Federation: FireFox browser plugin, that simplifies following and interacting with remote users on other Mastodon instances. ISC, Javascript

Reference material

Protocol specifications

  • ActivityPub Ontology (site): Turtle definitions of ActivityStreams 2.0 and Mastodon Toot vocabularies. MIT, Turtle

  • LitePub (Fedi account): A set of extensions to AP, being developed by devs from Pleroma and Mastodon (status: for the most part litepub group folded back into SocialCG, see: issue)

  • NodeInfo: Defines a standardized way to expose metadata about an installation of a distributed social network. CC0

  • Podcasting: Workspace for defining ActivityPub and ActivityStream extensions for Podcasting with the intention to define a W3C Recommendation for them.

  • SciFed (Fedi accounts: @rigelk, @cerisara): A specification standard (Draft) for federation of scientific activities and content using ActivityPub, developed as part of the OLKi project.

  • NodeInfo2 (Fedi account): An effort to create a standardized way of exposing metadata about a server. CC0-1.0

API documentation

Tutorials

Getting started

ActivityPub server-to-server (S2S)

  • Tutorial: A simple FediVerse Server: Building an ActivityPub Server to perform simple activities: post / follow / accept follow request. Tutorial also covers HTTP Signatures and WebFinger usage in bovine.

ActivityPub client-to-server (C2S)

WebFinger

Security

NodeInfo

Research & Development

Datashards

Object capabilities

Federated auth/authz

Content addressing

Distributed Mutable Containers

  • Distributed Mutable Containers (DMC): Distributed data structures that can hold references to content while allowing replicas of the data structures to diverge and merge without conflict (developed by DREAM)

Peer-to-peer networking

Maintainers

If you have questions or feedback regarding this list, then please create an Issue in our tracker, and optionally @mention one or more of our maintainers:

Contributors

With delight we present you some of our delightful contributors (please add yourself if you are missing).

License

CC0 Public domain. This work is free of known copyright restrictions.