mirror of
https://gitlab.melroy.org/melroy/fediresolve.git
synced 2025-06-07 20:08:57 +00:00
65 lines
1.6 KiB
Markdown
65 lines
1.6 KiB
Markdown
# 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, Lemmy, PeerTube, and others.
|
|
|
|
## 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, Note, Article, Create, Announce, etc.)
|
|
- Automatic resolution of shared/forwarded content to the original source
|
|
|
|
## Installation
|
|
|
|
### Prerequisites
|
|
|
|
- Go 1.16 or later
|
|
|
|
### Building from source
|
|
|
|
```bash
|
|
git clone https://gitlab.melroy.org/melroy/fediresolve.git
|
|
cd fediresolve
|
|
go build
|
|
```
|
|
|
|
## Usage
|
|
|
|
### Basic usage
|
|
|
|
```bash
|
|
# 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 Mastodon post
|
|
|
|
```bash
|
|
./fediresolve https://mastodon.social/@Gargron/12345
|
|
```
|
|
|
|
### Resolving a user profile
|
|
|
|
```bash
|
|
./fediresolve @Gargron@mastodon.social
|
|
```
|
|
|
|
## How it works
|
|
|
|
FediResolve uses the following process to resolve Fediverse content:
|
|
|
|
1. For handles (@username@domain.tld), it uses the WebFinger protocol to discover the ActivityPub actor URL
|
|
2. For URLs, it attempts to fetch the ActivityPub representation directly
|
|
3. It checks if the content is shared/forwarded and resolves to the original source if needed
|
|
4. It parses the ActivityPub JSON and displays both the raw data and a formatted summary
|
|
|
|
## License
|
|
|
|
MIT
|