Reviving Anime Offline Database: Automated Cross-Referencing Across 13 Platforms
The Motivation Behind the Project
For years, the anime developer community relied on the open-source manami-project/anime-offline-database to link entries across MyAnimeList, AniList, Kitsu, and TMDB. When the project was archived in July 2026, countless media trackers, scrapers, and Plex/Jellyfin plugins were left stranded with stale data. I stepped in to rebuild and modernize the pipeline: creating a fully automated, weekly-updated drop-in replacement that deterministically links 39,000+ anime across 13 major platforms with zero manual bottlenecks.
Core Features and Design Goals
- 13-Platform Cross-Referencing: Unifies MyAnimeList, AniList, Kitsu, AniDB, IMDb, TMDB, TVDB, Anime-Planet, AniSearch, Simkl, ANN, AnimeCountdown, and LiveChart.
- Automated API Auto-Enrichment: Automatically resolves new broadcast seasons, studios, episode counts, synonyms, and high-res cover art using public Jikan and Kitsu APIs.
- 100% Drop-In Schema Compatibility: Exact JSON structure parity with the legacy manami-project format, requiring zero code changes for existing client libraries.
- Automated Weekly Releases: Cron workflow running every Sunday on GitHub Actions, generating minified and indented distribution JSONs.
- ODbL-1.0 Open Data Licensing: Guaranteed open data access for the community under the Open Database License.
Deep Dive: How It Works Under the Hood
The fatal flaw of the original project was manual pull-request reviews: maintainers had to manually verify every single title addition and ID mapping. My re-implementation replaced this with deterministic linking based on curated lists (Fribb/anime-lists) combined with automated fallbacks to Jikan (MAL) and Kitsu APIs for title synonyms, season classifications, and thumbnail assets. The entire 39,000-entry database builds and verifies automatically in under 8 minutes.
Technical Implementation
- Engineered deterministic ID cross-referencing connecting 13 distinct media platforms.
- Built resilient rate-limited API workers to enrich newly announced anime entries.
- Maintained strict schema compliance with legacy community tooling.
The Technology Stack
Node.js, TypeScript, REST APIs (Jikan, Kitsu), and GitHub Actions.
Final Reflections
Community open-source projects thrive when manual maintenance bottlenecks are eliminated through robust automated pipelines and resilient data contracts.