Run with Docker
Drop in a docker-compose.yaml, set a couple of env vars, and you’re live.
docker compose up -d
docker compose kill -s HUP cross-postSIGHUP reloads accounts without dropping the WebSocket.
Snapbird · Bluesky → Mastodon
Post once on Bluesky.
Show up on Mastodon.
Snapbird is a small, self-hosted bridge that mirrors your Bluesky
posts to Mastodon in real time — preserving images, alt‑text, and
rewriting @mentions and links so they land cleanly on the other side.
Features
Built for the way fediverse-curious people actually post.
-
Real-time mirroring
Subscribes to Bluesky’s Jetstream firehose and posts to Mastodon the moment your skeet lands. No polling, no cron.
-
Smart mention rewriting
Tries to resolve each
@handleto its Mastodon account. Falls back to the Bluesky profile URL when no link exists, and skips posts where the swap would silently turn into a reply. -
Images, with alt text
Pulls full-size images from Bluesky, uploads them to Mastodon, and forwards the alt text along with them. Accessibility carries over.
-
Link facets, expanded
Bluesky’s shortened display text gets replaced with the real URL on Mastodon, so links remain clickable and obvious.
-
Hosted or self-hosted
Use the hosted service at snapbird.org and skip the setup, or run it yourself with Docker for a personal single-user deployment.
-
Replies stay on Bluesky
Replies aren’t mirrored. Only standalone posts cross over — so your Mastodon timeline doesn’t fill with one-sided fragments.
Deploy
One container. One database file. Done.
Manage from the CLI
A built-in cli.mjs mirrors every admin operation for scripting and headless use.
pnpm manage accounts add \
--did did:plc:abc... \
--masto-url https://front-end.social/api/v1 \
--token <mastodon-token>Or use the dashboard
A small web UI for adding accounts, pasting Mastodon tokens, and toggling accounts on or off. No login on a self-hosted install — the dashboard is open to whoever can reach it.
Open dashboard