AniList smart home integration, free and open source

Upcoming episodes of the anime on your AniList list in the Gladys calendar, dashboard and scenes.
The upcoming episodes of the anime on your AniList list in Gladys: a calendar per user, a dashboard widget and scene triggers. AniList is free; reading a public list needs no account on the Gladys side and no API key.
This integration is not affiliated with AniList. It was tested against the real AniList API and the test double of Gladys, not yet on a real Gladys instance: feedback welcome on the forum or on GitHub.
What you get
- An "Anime" calendar per user, in the Gladys calendar: every episode of the anime you watch (and, if you wish, plan to watch) on AniList, from two weeks back to three months ahead, with its episode number (Episode 7/12). The time is the broadcast in Japan converted to the time zone of Gladys (23:00 in Tokyo appears at 15:00 in Paris); each episode lasts its duration and links to its AniList page.
- A dashboard widget, "Upcoming episodes": the coming episodes, then where each anime stands (next episode in 3 days, on hiatus, not aired yet).
- Two scene triggers: a followed anime airs an episode today (in the morning or at its air time), and a new episode is announced for an anime that had none (a first air date, a return from a hiatus).
- A scene action, "Read the next episode": the next episode of an anime, the days left and its status.
The calendar view, the dashboard calendar and the built-in "calendar event is coming" trigger of Gladys also work with these calendars once they are shared.
Configuration
Each user enables the integration on its page, under "My calendars", and fills in:
- AniList user name: your name on AniList (
Josh), or the address of your profile (https://anilist.co/user/Josh/). Your list must be public: a private profile cannot be read without signing in, and the integration does not sign in. - Anime followed: "Watching", "Watching and planning" (default) or "Planning". Finished anime cost nothing: only the ones airing, about to air or just over are read.
- Language of the titles: romaji (
Sousou no Frieren, default), English (Frieren: Beyond Journey's End) or Japanese (葬送のフリーレン). A title missing in that language is replaced by another.
The description of your calendar says whose list was read, how many anime it holds, which ones are airing and which ones have no date yet, or why nothing was read (unknown user, private list).
The calendar is private at first. Share it (the toggle under "My calendars") to see it on the dashboard and to use it in scenes: like every Gladys calendar, only shared calendars reach the scenes, and a shared calendar is visible to the whole household.
The administrator chooses the language of the dates and statuses passed to the scenes. Calendar names and descriptions follow the language of each user.
Actions
On the integration page, for the administrator:
- Check: reads AniList again now for every user, and says how many anime were read and how many have a dated next episode.
Scenes
Trigger "Episode today": a followed anime (on a shared calendar) airs an episode today. The When filter chooses the moment: in the morning (09:00), or at the air time. The Anime filter takes the exact title as shown in the calendar; empty, every anime. Variables: anime, episode number, number of episodes (0 when unknown), date and time, air time, AniList page, and the users who follow the anime.
Trigger "New episode announced": a followed anime that had no next episode gets one: a first air date for an anime not aired yet, a return from a hiatus. An anime dated week after week is not announced at every episode. Same variables, plus the days left.
Action "Read the next episode": the next episode of an anime (any of its titles, or the beginning
of one; empty: the soonest of all), with found (1 or 0), episode, number of episodes, date, time,
days_left (-1 without a date), status and last episode aired.
Examples:
- Tell the household the day an episode airs: trigger "Episode today", when "In the morning", then the Gladys action "Send a message" to the users you choose, its text built with the variables Anime, Episode and Time picked from the list. Nothing is sent until you create such a scene.
- Know when the next season is dated: trigger "New episode announced", then a message with the Anime and Date variables.
- Weekly reminder: a scheduled scene on Sunday evening, the action "Read the next episode", then a message with its Anime and Date outputs.
Dashboard
Add the Upcoming episodes widget to a dashboard. Settings: the anime to show (exact titles; empty, every shared anime), the period (7, 14 or 31 days) and whether to show the status of each anime.
Limits
- Data: AniList's airing schedule, which is the broadcast in Japan. A simulcast on a streaming platform (Crunchyroll, ADN, Netflix) can come an hour or a few days later; a dub much later.
- Refresh: every 3 hours, and when a user changes their account. AniList allows 30 requests a minute: the integration spaces its requests (one every 2 seconds at most), reads each list once and asks for the episodes of every user together.
- AniList dates most anime a few weeks ahead. An anime announced for "October 2027" has no episode in the calendar until AniList dates it: the calendar description lists it under "No date yet".
- The calendar shows three months ahead: an anime dated a year ahead (Crayon Shin-chan) does not fill it with 50 episodes. At most 500 episodes per calendar.
- Private lists are not supported (no AniList sign-in).
Troubleshooting
- The calendar stays empty: check its description (Gladys calendar page). "No AniList user named…" means the name is wrong; "private" means your profile must be made public in your AniList settings.
- An anime is missing: check its status on your AniList list (Watching or Planning) and the "Anime followed" setting. A finished anime has no upcoming episode.
- No scene fires: the calendar must be shared, and the anime filter must be the exact title shown in the calendar.
- "AniList unreachable": the integration keeps the previous episodes and tries again, after a
minute then less and less often. Logs: integration page, Logs tab (
LOG_LEVEL=debugfor more detail).
Credits
Anime and airing data come from the AniList API, used under its terms of use (free, non-commercial). Every calendar and event description credits AniList.
Configuration settings
These are the settings AniList asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| How it works | section | No | Each user enables the integration below, under "My calendars", and types their AniList user name (public list). The episodes of the anime they watch or plan to watch fill an "Anime" calendar, at the local time of the broadcast in Japan. Share it with the household to see it on the dashboard and use it in scenes. Data: AniList, free, no key. |
| Language of the scene texts | select | No | Dates and statuses passed to the scenes. Calendars follow the language of each user. |
How to install AniList in Gladys
- In Gladys, open Integrations: AniList appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/guim31/gladys-anilist:1.0.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/guim31/gladys-anilist.
AniList requires Gladys >=5.2.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
AniList is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by guim31, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation