Skip to content
Karl Ostendorf

mastodon reposter

Go back

Better Mastodon hashtag discovery

Reposter exists because Mastodon discovery is uneven. Your home server only knows about part of the Fediverse, so followed hashtags can miss posts that are visible elsewhere.

Reposter is a small Node.js/TypeScript CLI that checks the hashtags followed by your personal Mastodon account across configured discovery servers. When it finds a matching post, it filters it, then asks your own Mastodon server to resolve the remote post URL.

It does not boost, favorite, post, or republish anything. Despite the name, it is a discovery helper, not an automated reposting bot.

Before resolving a post, Reposter skips posts from your own account, blocked hashtags, ignored authors, ignored servers, duplicates, and posts with too many tags if configured. If allowedLanguages is set, only those languages are accepted; if it is omitted, Reposter does not filter by language. It also respects a private relationship-note opt-out: authors with #NoRepost in your note are skipped.

The tool is designed for scheduled unattended runs with cron, systemd timers, or launchd. It stores state in SQLite so it can remember seen posts and resume from the newest status per server and hashtag.

In short: Reposter uses other Mastodon servers as hashtag lookouts, applies your local rules, and helps your own server discover posts you might otherwise never see.



Next Post
dayone2md