mackuba.eu / tootify
Toot toooooooot (Bluesky-Mastodon cross-poster)
fork atom
Ruby 100.0%
47 1 0

Clone this repository

https://tangled.org/mackuba.eu/tootify
git@tangled.org:mackuba.eu/tootify

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

Tootify 🦋→🐘#

A simple Bluesky-to-Mastodon cross-posting service

What does it do#

Tootify allows you to do a selective one-way sync of Bluesky posts to your Mastodon account.

The way it works lets you easily pick which skeets you want to turn into toots: it scans your recent posts and checks which of them you have liked yourself, and only those posts are reposted. The self-like is automatically removed afterwards.

Currently handles:

  • post with link embeds
  • quotes – posted as "RE: bsky.app/..."
  • images (with alt text)
  • videos
  • threads of multiple chained posts from you

Installation#

To run this tool, you need some reasonably recent version of Ruby installed – although it's recommended to use a version that's still getting maintainance updates, i.e. currently 3.2+. A recent Ruby version is likely to be preinstalled on most Linux systems, or at least available through the OS's package manager, otherwise you can install one using tools such as RVM, asdf, ruby-install or ruby-build (see more installation options on ruby-lang.org).

To install the app, run:

git clone https://tangled.org/mackuba.eu/tootify
cd tootify
bundle install

Usage#

First, log in to the two accounts:

./tootify login johnmastodon@example.com
./tootify login @alf.bsky.team

Press like on the post(s) on Bluesky that you want to be synced to Mastodon.

Then, you can either run the sync once:

./tootify check

Or run it continuously in a loop:

./tootify watch

By default it checks for new skeets every 60 seconds – use the interval parameter to customize the interval:

./tootify watch --interval=15

Configs#

Tootify stores configs and data in the config folder:

  • bluesky.yml – created when you log in, stores Bluesky user ID/password and access tokens
  • mastodon.yml – created when you log in, stores Mastodon user ID/password and access tokens
  • tootify.yml - optional additional configuration

The config in tootify.yml currently supports one option:

  • extract_link_from_quotes: true – if enabled, posts which are quotes of someone else's post which includes a link will be "collapsed" into a normal post that just includes that link directly without the quote (so the link card on Mastodon will show info about the link and not the quoted bsky.app post)

There is also an SQLite database file that's automatically created in db/history.sqlite3. It stores a mapping between Bluesky and Mastodon post IDs, and is used to maintain reply references in threads.

Credits#

Copyright © 2025 Kuba Suder (@mackuba.eu).

The code is available under the terms of the zlib license (permissive, similar to MIT).

Bug reports and pull requests are welcome 😎