An offline-first, high-performance anime metadata information provider (scraper) add-on for Kodi. This provider bridges the gap between Eastern anime tracking tracking mechanics (absolute episode numbering arrays used by AniList/MyAnimeList) and Western media management standards (the standard S01E01 paradigm).
By adapting the clean architecture of Kodi's official metadata.tvdb.com.python scraper and incorporating the rich mapping assets generated by the Otaku add-on community, this provider runs zero-latency library lookups locally without risk of rate-limiting blocks or external API dependency dropouts.
- ⚡ Zero-Latency ID Translation: Queries a local, pre-compiled SQLite relational database (
anime_mappings.db) to instantly map AniList or MyAnimeList source references to target TVDB/TMDb identifiers in under 0.01 seconds. - 🛡️ API Rate-Limit Immunity: Eliminates high-volume REST lookups against indexing servers (like AniZip or MALSync) during initial directory scans, protecting user environments from diagnostic IP bans.
- 🧩 Perfect Multi-Season Mapping: Automatically translates continuous absolute episode streams (e.g., Episode 75) into standard media player structures using explicit metadata matching tables (
thetvdb_season,thetvdb_part). - 📡 Hybrid Processing Engine: Discovers trending streams via AniList's ultra-fast GraphQL infrastructure and falls back gracefully to secondary data pools matching user settings.
- 🔄 Asynchronous Database Syncing: Runs non-blocking background file checking intervals to safely sync down up-to-date community mapping updates from the upstream master repository without causing visual UI stuttering.
- 🌍 Localization Flexibility: Features independent language preference controls (
EnglishorRomaji) for both the Indexer (Kodi GUI) and the included directory Renamer tool. - 🎬 Dedicated Movie Scraper: Added native support for anime movies, OVAs, ONAs, and specials through TMDb's movie database and custom scraper hooks.
- 🎨 Premium Artwork Engine: Native integration with Fanart.tv to pull high-quality transparent Clearlogos, Cleararts, Thumbs, and Fanart directly into Kodi 20+ skins.
- 🗂️ Advanced Library Renamer: Context-menu tool that automatically restructures disorganized files into standard Kodi layouts (e.g.
Show Name (Year)/Season 01/S01E01 - Title.ext). - 📦 Settings Management: Includes an advanced configuration dashboard featuring instant Backup and Restore capabilities for safe settings preservation.
- 📝 Custom Diagnostic Logging: Features an advanced logging engine allowing you to define custom diagnostic log directories separate from the standard
kodi.logfor easy troubleshooting. - 🛠️ Robust Exception Interception: Features an isolated diagnostic execution ring (
debugger.py) that captures raw application-level trace vectors, logging errors gracefully into the system storage layout.
- Goldenfreddy0703: Massive thanks for his code contributions and the foundational anime database mappings that power this scraper.
The framework functions directly inside Kodi's native metadata extraction rings (xbmc.metadata.scraper.tvshows and xbmc.metadata.scraper.movies) across four decoupled lifecycle hooks:
[ Step 1: find ] --> Searches for the matching show/movie title using the AniList GraphQL engine.
│
[ Local Mapping Lookup ] --> Pulls the structural translation mapping parameters via local SQLite.
│
[ Step 2: getdetails ] --> Hydrates high-level series/movie assets (Plot, Posters, Banner Art, Fanart).
│
[ Step 3: getepisodelist ] --> Compiles the explicit SxxExx directory containing target episode keys (TV shows only).
│
[ Step 4: getepisodedetails]--> Resolves granular localized metadata descriptions per matching video node (TV shows only).
- License & Credits: Switched to GPLv3 license and added credits for Goldenfreddy0703's DB and code contributions.
- Advanced Renamer Options: Added comprehensive folder, season, and episode formatting templates to the Otaku Renamer, supporting dynamically injected AniList
seasonYearmappings and Kodi-standardShow Name - Season 01 (Year)structure parsing.
- Fanart.tv Provider: Added support for extracting and injecting premium Clearlogos, Cleararts, and Thumbs from Fanart.tv.
- Artwork Settings: Expanded the Settings menu with new Fanart.tv API configuration and granular artwork toggles.
- Settings Tabbed Interface: Refactored settings to categorize options under Indexer, Renamer, Metadata, Fan Art, Accounts, Logging, and Advanced.
- English Title Default Fix: Resolved a case-sensitive issue where default English language setting wasn't correctly resolved, reverting titles to Romaji.
- Dynamic Multi-Provider Ratings: Added primary/secondary rating selectors with fallbacks (AniList, MAL, TMDb, Simkl) and multi-rating Kodi 20+ injection.
- Otaku Renamer Overhaul: Fixed prefix filename collisions, supported recursive directories, matched split seasons, and added parent-folder mappings.
- Dedicated Anime Movie Scraper: Mapped anime movies, OVAs, ONAs, and specials through TMDb's movie database and custom scraper hooks.