an attempt to map episodes from MyAnimeList (MAL) to Trakt (and other dbs) and vice versa.
de-kakuran is a collection of mapping data and a domain-specific language (DSL) designed to bridge the gaps in episode numbering between various anime databases. it provides a centralized, human-readable source of truth for handling complex episode correlations.
- introduction: project goals and reasoning.
- formatting: detailed specification of the mapping language and TSV structure.
- structure: directory layout and column definitions.
- setup: how to set up the project locally.
- contributing: how to add or update mappings.
- integration: guide for using these mappings in your own tools.
the core data is stored in the mappings/ directory as TSV files (e.g., mal-trakt.tsv).
de-kakuran includes several Python utilities to help maintain and expand the mapping database:
add_mapping.py: Import a new title mapping using Trakt and MAL references. Supports fuzzy sequential matching, absolute numbering, and automatic arc detection.bulk_sync.py: Main engine for validating existing mappings and bulk-importing data from the source repository.check_relations.py: Recursively map out the entire relation tree (sequels, prequels, side stories) of a series to identify missing mappings.trakt_search.py: Search utility for finding Trakt IDs, slugs, and season metadata from various URL formats or identifiers.validate_data.py: Data validation tool to ensure all mapping files follow the structural and syntax standards.
See the setup guide for installation and usage instructions.
this project is released under the MIT License.