Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kawamataryo/sky-follower-bridge
Instantly find and follow the same users from your X(Twitter) follower on Bluesky.
https://github.com/kawamataryo/sky-follower-bridge
bluesky chrome-extension twitter
Last synced: 1 day ago
JSON representation
Instantly find and follow the same users from your X(Twitter) follower on Bluesky.
- Host: GitHub
- URL: https://github.com/kawamataryo/sky-follower-bridge
- Owner: kawamataryo
- License: mit
- Created: 2023-05-19T13:31:45.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-09T04:24:14.000Z (16 days ago)
- Last Synced: 2024-12-09T08:52:26.421Z (15 days ago)
- Topics: bluesky, chrome-extension, twitter
- Language: TypeScript
- Homepage: https://www.sky-follower-bridge.dev
- Size: 19 MB
- Stars: 727
- Watchers: 8
- Forks: 28
- Open Issues: 56
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-bluesky - sky-follower-bridge - Migrate X Followers/Following to Bsky (Migration / Web)
README
# Sky Follower Bridge
[](https://ko-fi.com/X8X315UWFN)
Instantly find and follow the same users from your 𝕏(Twitter) follows on Bluesky.
https://github.com/kawamataryo/sky-follower-bridge/assets/11070996/67bdd228-dc67-4d0a-ac18-f3a3e0c7adf9
## 📖 Documentation
- [Getting Started](https://www.sky-follower-bridge.dev/get-started)
- [Troubleshooting](https://www.sky-follower-bridge.dev/troubleshooting)
## 📦 Installation
- [Chrome Web Store](https://chrome.google.com/webstore/detail/sky-follower-bridge/behhbpbpmailcnfbjagknjngnfdojpko) (Recommended)
- [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/sky-follower-bridge/)
- [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/sky-follower-bridge/dpeolmdblhfolkhlhbhlofkkpaojnnbb)
> [!NOTE]
> We recommend using the Chrome Web Store version as it's always up to date. Other store versions may lag behind in updates.
## 🚀 How to use
1. On 𝕏 open Your [Following](https://x.com/following), [Followers](https://x.com/followers), or [Blocked](https://x.com/settings/blocked/all) users list, or the Members page of a public List.
2. Use the `Alt + B` shortcut or click on the toolbar icon to launch the Sky Follower Bridge extension.
3. Input your Bluesky login email or handle and an [app password](https://bsky.app/settings/app-passwords).
4. Press the `Finding Bluesky Users` btn.
5. Bluesky users will appear in the Modal.
6. Click the "Follow" button to follow them on Bluesky.
> [!TIP]
> For Firefox users, pressing `Alt + B` may not work. In that case, click the extension icon in the browser toolbar.
> https://support.mozilla.org/en-US/kb/extensions-button
## 🔧 Troubleshooting
- Please feel free to mention [@kawamataryo.bsky.social](https://bsky.app/profile/kawamataryo.bsky.social) on Bluesky. They will provide support to ensure the tool is functioning properly.
- If you get the error "Error: Something went wrong. ...", **please reload the page** and then click on the extension icon again.
## 🚨 Limitations
- User search may fail due to rate limit in Bluesky's API. In this case, please wait for 2 to 3 minutes and execute the search again.
## Development
### Environment Variables
- `PLASMO_PUBLIC_BSKY_DOMAIN`: The Bluesky domain to use (default: "bsky.social")
## Building for Custom PDS Servers
If you want to use this extension with a custom PDS (Personal Data Server) instead of the default bsky.social, you have two options:
### Option 1: Using .env file
1. Clone the repository:
```bash
git clone https://github.com/kawamataryo/sky-follower-bridge.git
cd sky-follower-bridge
```
2. Install dependencies:
```bash
npm install
```
3. Create a `.env` file in the root directory:
```bash
echo "PLASMO_PUBLIC_BSKY_DOMAIN=bsky.social" > .env
```
4. Build the extension:
```bash
# For Chrome
npm run build
npm run package
# For Firefox
npm run build:firefox
npm run package:firefox
```
### Option 2: Using environment variable directly
You can also pass the domain directly during build:
```bash
# For Chrome
PLASMO_PUBLIC_BSKY_DOMAIN=your-custom-domain.com npm run build
PLASMO_PUBLIC_BSKY_DOMAIN=your-custom-domain.com npm run package
# For Firefox
PLASMO_PUBLIC_BSKY_DOMAIN=your-custom-domain.com npm run build:firefox
PLASMO_PUBLIC_BSKY_DOMAIN=your-custom-domain.com npm run package:firefox
```
### Loading the Built Extension
After building, you can load the extension:
**For Chrome/Edge:**
1. Go to `chrome://extensions/` (or `edge://extensions/`)
2. Enable "Developer mode" in the top right
3. Click "Load unpacked"
4. Select the `build/chrome-mv3-prod` directory
**For Firefox:**
1. Go to `about:debugging#/runtime/this-firefox`
2. Click "Load Temporary Add-on"
3. Select the zip file from the `dist` directory
### Notes
- The built extension will be in the `build` directory
- The packaged extension (.zip) will be in the `dist` directory
- When using a custom PDS, users will need to use handles in the format `username.your-custom-domain.com`
- Make sure your custom PDS server is compatible with the AT Protocol