indexx.dev / tweets2bsky
forked from j4ck.xyz/tweets2bsky
A simple tool which lets you scrape twitter accounts and crosspost them to bluesky accounts! Comes with a CLI and a webapp for managing profiles! Works with images/videos/link embeds/threads.
fork atom
tweets2bsky / README.md
at 336c1506cee87f0b593a2bb090bb66c8e9f87feb 2.5 kB view raw view code
jack feat: add web dashboard with auth and owner-based mapping management
20783b55

🐦 Tweets-2-Bsky#

Note: This project is built on top of bird by @steipete, which provides the core Twitter interaction capabilities.

A powerful tool to crosspost your Tweets to Bluesky automatically. Now features a Web Dashboard for easy management, Multi-account support for different owners, and Custom PDS hosting support.

✨ Features#

  • Web Dashboard: Modern interface to manage all your sync tasks.
  • Multi-User Mapping: Let others add their accounts (e.g., Dan, Josh) with their own owners.
  • Multi-Account Support: Sync Twitter A -> Bluesky A, Twitter B -> Bluesky B, etc.
  • Tailscale Ready: Accessible over your local network or VPN.
  • Interactive CLI: Manage everything from the terminal with ./crosspost.
  • High Quality: Supports threads, high-quality images, and videos.

🚀 Quick Start#

1. Prerequisites#

  • Node.js installed.
  • A Twitter account (burner recommended) for global cookies.
  • Bluesky account(s) with App Passwords.

2. Installation#

git clone https://github.com/j4ckxyz/tweets-2-bsky.git
cd tweets-2-bsky
npm install
npm run build

3. Start Syncing & Web UI#

# This starts both the sync daemon AND the web dashboard
npm start

By default, the web interface runs at http://localhost:3000. If you are using Tailscale, it's accessible at http://your-tailscale-ip:3000.

4. Setup (Web Dashboard)#

  1. Open the dashboard in your browser.
  2. Register a new account (email/password).
  3. Log in and go to Global Twitter Config to enter your cookies.
  4. Use Add New Mapping to connect a Twitter handle to a Bluesky account.

🛠 Advanced Usage#

Disable Web Interface#

If you only want to run the sync daemon without the web UI:

npm start -- --no-web

Command Line Interface (CLI)#

You can still manage everything via the terminal:

# Set Twitter cookies
./crosspost setup-twitter

# Add a mapping
./crosspost add-mapping

# List/Remove
./crosspost list
./crosspost remove

Backfilling Old Tweets#

# Example: Import the last 20 tweets for a user
npm run import -- --username YOUR_TWITTER_HANDLE --limit 20

⚙️ How to get Twitter Cookies#

  1. Log in to Twitter in your browser.
  2. Open Developer Tools (F12) -> Application tab -> Cookies.
  3. Copy auth_token and ct0 values.

⚖️ License#

MIT