syncribullet

syncribullet copied to clipboard

• Table of Contents :toc:

• [[#info][Info]]
  • [[#goal][Goal]]
  • [[#help][Help]]
  • [[#warning][WARNING]]
• [[#todo][ToDo]]
  • [[#dynamic-sync][Dynamic Sync]]
  • [[#import-sync][Import Sync]]
  • [[#advanced-sync][Advanced Sync]]
  • [[#two-way-sync][Two-Way Sync]]
  • [[#catalogs][Catalogs]]
• [[#use-the-addon][Use the Addon]]
• [[#modify-and-build-yourself][Modify and Build yourself]]
  • [[#build][Build]]
  • [[#start][Start]]
  • [[#develop][Develop]]
• [[#known-issues][Known Issues]]
• [[#what-else][What else?]]
  • [[#naming][Naming]]
  • [[#pull-requests][Pull Requests]]
  • [[#stars][Stars]]
  • [[#contact][Contact]]
  • [[#support][Support]]

• Info Currently the addon synchronizes with following services:

• Anilist
• Simkl

I plan on adding the following in the near future:

• MyAnimelist
• Kitsu
• 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.

** Help If you want to help, the next step is adding mappings between the services to a generalized format.

*** Syncing The idea is that everything is the same everywhere. So a mapping to check what should be synced would look like:

#+begin_src typescript let lastWatched; if (symkl.last_watched_at > stremio.state.lastWatched) { lastWatched = symkl.last_watched_at; } else if (anilist.mediaEntry.last_watched) { lastWatched = anilist.mediaEntry.last_watched; } #+end_src

*** Mapping Information should be mapped as much as possible. After deciding the leader of the sync, we get all possible values and fill up the rest: #+begin_src typescript // If Symkl has lastWatched if (symkl.state === "completed") { stremio.state.flaggedAsWatched = true anilist.state = "COMPLETED" } // If Anilist has lastWatched if (symkl.state === "COMPLETED") { stremio.state.flaggedAsWatched = true symcl.state = "completed" } #+end_src

** 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.

• [X] Dynamic Sync from Stremio to Anilist
• [ ] Dynamic Sync from Stremio to Kitsu
• [ ] Dynamic Sync from Stremio to MyAnimelist
• [X] Dynamic Sync from Stremio to Simkl
• [-] Dynamic Sync from Stremio to Trakt (Already native Support use that)

** 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 MyAnimelist
• [-] Import Sync from Stremio to Simkl (Alternative until tested: [[https://github.com/aliyss/simkl-stremio][simkl-stremio]])
• [-] Import Sync from Stremio to Trakt (Alternative until tested: [[https://github.com/aliyss/trakt-stremio-import][trakt-stremio-import]])

** 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.

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

• [X] Anilist
• [ ] Kitsu
• [ ] MyAnimelist
• [X] Simkl
• [ ] Trakt

• Use the Addon

[[https://56bca7d190fc-syncribullet.baby-beamup.club/][Click here!]]

• Modify and Build yourself

** Build

#+begin_src bash npm install npm run build #+end_src

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

#+begin_src bash npm run start #+end_src

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

#+begin_src bash npm run start:dev #+end_src

• 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

• [[https://discord.gg/zNRf6YF][Stremio Addons Discord Server]]

• [[https://discord.com/invite/u89XfYn][Simkl Discord Server]]

• [[https://discord.com/invite/TF428cr][AniList Discord Server]]

• [[https://discord.com/invite/zAypMTH][Aliyss' Discord Server]]

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

[[https://www.buymeacoffee.com/aliyss][Buy Me A Coffee]]