FediResolve

FediResolve is a command-line tool for resolving and displaying Fediverse content.

It can parse and display ActivityPub content from various Fediverse platforms including Mastodon, Mbin, Lemmy, PeerTube, and others. For easy reading or debugging purposes.

Features

Resolve Fediverse URLs to their ActivityPub representation
Resolve Fediverse handles (e.g., @username@domain.tld)
Display both the full JSON data and a human-readable summary
Support for various ActivityPub types (Person, Page, Note, Article, etc.)
Automatic resolution of shared/forwarded content to the original source

Download

FediResolve for Linux

Installation

Either download the prebuild binary from releases or build from source, see below.

Prerequisites

Go 1.21 or later

Building from source

git clone https://gitlab.melroy.org/melroy/fediresolve.git
cd fediresolve
go build

Usage

Basic usage

# Provide a URL or handle as an argument
./fediresolve https://mastodon.social/@user/12345
./fediresolve @username@domain.tld

# Or run without arguments and enter the URL/handle when prompted
./fediresolve

Examples

Resolving a Mbin thread

./fediresolve https://kbin.melroy.org/m/til/t/875629/Context7-Up-to-date-documentation-for-LLMs-and-AI-code-editors

Resolving a Mastodon post

./fediresolve https://mastodon.melroy.org/@melroy/114297155915355913

Resolving a user profile

./fediresolve @melroy@melroy.org

How it works

FediResolve uses the following process to resolve Fediverse content:

For handles (@username@domain.tld), it uses the WebFinger protocol to discover the ActivityPub actor URL
For URLs, it attempts to fetch the ActivityPub representation directly. Or if the content is needs to be resolved from another Fediverse instance.
Content is parsed and displays both the raw JSON object and a nice looking summary.

License

MIT

2.1 KiB Raw Blame History