animeo
animeo copied to clipboard
Stremio addon that integrates Anilist tracking
Animeo
This is a Stremio addon that uses the AniList API to track your anime series/movie progress.
How to use it
Go to the addon configuration URL, click on the ANILIST LOGIN button, and follow the remaining instructions on the page.
Then, just watch any anime through Stremio's Cinemeta or Kitsu catalogs. I strongly recommend using Kitsu, as the Kitsu ID of the anime will be converted to the equivalent AniList ID if there is an AniList entry available for the anime.
Movies watched through the Cinemeta catalog will have their IDs converted the same way, but series will be found by searching the AniList API with the name provided by Cinemeta, if you enable this option during configuration. This isn't recommended because it can often update your list with incorrect entries.
How does it work?
Up to this edit, there's no simple way (that I know of) to detect when a user finishes an episode or marks it as watched through the Stremio Addon SDK.
What I'm doing instead is using the defineSubtitlesHandler
function to send a request with the current episode to the AniList API. So, whenever you open a new episode, the addon will try to update your lists.
Limitations
-
No AniList catalog, which means the addon tries to find the AniList entry through the name provided by other meta providers (or converts the ID when coming from Kitsu, and Cinemeta for movies). I do plan to implement the catalogs eventually.
-
Right now, I'm supporting the Kitsu and Cinemeta catalogs. Kitsu has been working well, but due to the way Cinemeta handles anime parts and seasons, it will probably get some entries wrong.
-
AFAIK, there's no way of giving the user feedback about success/errors during the requests, so the user needs to verify periodically if the addon is working as intended.
Hosting the addon
To host the addon on your own machine, you'll need to:
- Create a new client in AniList. You'll need the client ID.
- While still on the client configuration page, set the redirect URL to
https://[your-addon-url]/configure
. - Change the
client_id
argument on thehref
attribute of the login button in the/static/config.html
file. - Run
npm install
. - Run
npm start -- --install
.
Feel free to open an issue if there is any doubt or problem.
Support
If you like what I do, consider buying me a coffee ;)