Post replication docker container to mirror BlueSky posts onto X/Twitter and Mastodon
README.md

An automated post mirror from BlueSky to X/Twitter and Mastodon #

This project is meant to significantly decrease the time spent on maintaining a network spanning social media presence, by automatically replicating posts from BlueSky in near realtime onto Twitter and Mastodon using the JetStream.

Not yet implemented! #

This is a super new project, so lots of things aren't yet there! Watch out, there be dragons!

Working: #

  • Replicating posts and splitting a post down roughly the middle if it's too long for Twitter
  • Replying to yourself (threads)
  • Images (even multiple), videos and GIFs
  • Qoute posts with "RE: link"
  • Retrying after failure
  • Disabling Twitter or Mastodon via env vars

Configuration #

All configuration is done via environment variables, the easiest way is to use the provided docker-compose.yml as it has everything ready to fill in, but you can of course also create the container manually or run the JS baremetal as long as these variables are either in .env or the envvars:

ENVVAR Description
BSKY_DID Enter your DID (did:plc:...), if you don't know what yours is look it up on ATProto-Browser
BSKY_PDS Your PDS URL, for BlueSky itself enter either your mushroom directly or the gateway https://bsky.social
JETSTREAM_URL The WebSocket URL of the JetStream to listen for posts on, if you don't run your own use wss://jetstream2.us-east.bsky.network
MASTODON_USERNAME Your full username in the format @user@instance.domain
MASTODON_TOKEN The token you got in the API settings page
MASTODON_INSTANCE Your instance domain, not the username domain! So for example fedi.instance.domain
TWITTER_KEY Twitter app key
TWITTER_SECRET Twitter app secret
TWITTER_TOKEN Twitter access token for the specific account
TWITTER_TOKEN_SECRET Twitter access token secret for the specific account
TWITTER_ENABLED Set to false to disable cross-posting to Twitter (default: true)
MASTODON_ENABLED Set to false to disable cross-posting to Mastodon (default: true)