syncribullet

syncribullet (v2)

syncribullet is a Stremio Addon that synchronizes your watchlist with other services.

[!NOTE]

• (2025.05.24) Added import sync for Simkl!

复制

  - No clean error handling yet, open up a PR to help out.

复制

  - Also delete cache if you want to rerun it from scratch.

复制

  - I did the most I could, for any issues please open up an issue.

复制

  - A mess up in an existing watchlist may be still possible. Read everything carefully before running it.

• (2025.05.03) Added support for reconfiguring the addon.
• (2025.03.09) Added support for TVTime! (awful API btw)
• (2025.03.06) Added support for Kitsu! (also helps with NSFW content)

Table of Contents

• Info
  • Goal
  • WARNING
• ToDo
  • Dynamic Sync
  • Import Sync
  • Advanced Sync
  • Two-Way Sync
  • Catalogs
• Use the Addon
  • Hosted
  • Docker
• Modify and Build yourself
  • Build
  • Start
  • Develop
• Known Issues
• What else?
  • Naming
  • Pull Requests
  • Stars
  • Contact
• Support
  • Special Thanks

Info

Currently the addon synchronizes with following services:

• Anilist
• Kitsu
• MDBList (implemented by @cgarst)
• Simkl
• TVTime

I plan on adding the following in the very near future:

• MyAnimelist
• Trakt

Goal

I want to implement a two way sync over multiple services with Stremio acting as the Sender and the watchlists acting as the Receivers.

WARNING

[!WARNING] I have tested this as good as possible. Everything published here is currently good to go and shouldn't mess up your library. That said if anything does happen... I can't guarantee anything. Open up an Issue and I may be able to help out.

ToDo

Dynamic Sync

Dynamic Sync is when an item in the Senders is updated, that it get's reflected on the Receivers.

• Dynamic Sync from Stremio to Anilist
• Dynamic Sync from Stremio to Kitsu
• Dynamic Sync from Stremio to MDBList
• Dynamic Sync from Stremio to MyAnimelist
• Dynamic Sync from Stremio to Simkl
• Dynamic Sync from Stremio to Trakt (Already native Support use that)
• Dynamic Sync from Stremio to TVTime

Import Sync

Import Sync is theoretically a one-time action where the whole library get's synchronised from the Senders to the Receivers and vice-versa. But the plan is, that this can be run multiple times without wierd issues.

• Import Sync from Stremio to Anilist
• Import Sync from Stremio to Kitsu
• Import Sync from Stremio to MDBList
• Import Sync from Stremio to MyAnimelist
• Import Sync from Stremio to Simkl
• Import Sync from Stremio to Trakt (Alternative until tested: trakt-stremio-import)
• Import Sync from Stremio to TVTime

Advanced Sync

Advanced Sync is when the theoretical Receivers share their data between each other, validating and keeping each other in sync.

• Sync between all Receivers

Two-Way Sync

Of course I'm going for the two-way sync. However this is harder than it actually seems at the moment. Due to not knowing what the prefered sync order is. And currently in discussion with Stremio to implement a way to have addons receive events for syncing.

Catalogs

Stremio Catalog Support, self explanatory if you are using stremio.

• Anilist
• Kitsu
• MDBList
• MyAnimelist
• Simkl
• Trakt
• TVTime

Use the Addon

Hosted

• Hosted by Stremio: Click here!
  • Catalog updates are limited to every 4hrs

Docker

Either get the image from docker. Or clone this repo.

# From Docker Hub
docker pull aliyss/syncribullet:latest

# From GitHub
git clone https://github.com/aliyss/syncribullet.git
docker build --build-arg PRIVATE_ENCRYPTION_KEY=runtime -t aliyss/syncribullet -f Dockerfile.local .

Afterwards run the image, by replacing s0m3runt1m3k3y with your own encryption key. Make sure your encryption key only contains alphanumeric characters and numbers (^[a-zA-Z0-9]$):

docker run --rm -it -p 3000:3000 -e PRIVATE_ENCRYPTION_KEY=s0m3runt1m3k3y aliyss/syncribullet

Modify and Build yourself

Build

npm install
npm run build

Start

Start the program. Then open the browser at the url mentioned, if this doesn't already happen automatically.

npm run start:local

Develop

Instead of Start. Use the following. This will allow you to see the changes live.

npm run start:dev

Known Issues

• Authtokens are not updated if they expire. I'm working on that.

What else?

Naming

I chose the name syncribullet, because I want to blend all of the tracking websites together in a synchronised mix. There's not much more to it.

Pull Requests

Feel free to open pull requests if you think there can be improvements made. I will add an eslint check asap.

Stars

A star would be kind, but honestly I use GitHub stars more as bookmarks. So instead bookmark it.

Contact

• Stremio Addons Discord Server
• Simkl Discord Server
• AniList Discord Server
• Aliyss' Discord Server (Mine ^^)

Support

If you like what I do consider buying me a coffee ;)

Paypal (preferred) Buy Me A Coffee

Special Thanks

• haumarco for saving an extra character when compressing the user settings.
• Anilist Wrapper for providing the initial code for the Anilist API, which I shamelessly copied and modified.