Skip to content

MyAnimeList Import

hcan359 edited this page Jul 18, 2026 · 4 revisions

MyAnimeList Import

Import your anime and manga lists from a MyAnimeList XML export. Entries are matched against AniList by MAL ID, with status, score, progress, and dates preserved.

What gets imported

MAL data Tonkatsu Box
Anime / manga entries Items matched to AniList by MAL ID
my_status Status (Watching/Reading → In Progress, On-Hold → Dropped, etc.)
my_score (1-10) User rating
my_watched_episodes Current episode (anime)
my_read_chapters / my_read_volumes Current chapter / volume (manga)
my_start_date / my_finish_date Started / Completed dates
my_tags Saved into the user comment
my_times_watched / my_times_read Saved into the user comment
my_comments Appended to the user comment
Entries not found on AniList Added to Wishlist with the MAL note

A link back to the MyAnimeList page (https://myanimelist.net/anime/<id> or /manga/<id>) is added to every imported item's comment.

Tonkatsu Box has no separate "On-Hold" status, so MAL's On-Hold entries come in as Dropped, which already covers a title you have paused.

Requirements

  • No API key needed - the importer reads a local XML file you export from MAL.
  • Internet connection - used to resolve MAL IDs to AniList entries.

How to export your MAL list

  1. Open myanimelist.net/panel.php?go=export (you must be signed in).
  2. Choose Anime List or Manga List and click Export My List.
  3. MAL gives you a .xml.gz archive - unpack it to get the .xml file.
  4. Repeat for the other list if you want to import both anime and manga.

How to import

  1. In Tonkatsu Box: go to Settings → Import → MyAnimeList
  2. Add the Anime list XML file and/or the Manga list XML file (at least one is required)
  3. Choose target collection:
    • Create new collection - creates a new collection with a name you provide
    • Use existing collection - pick one from the dropdown
  4. Tap Start Import

Import progress

During import you'll see:

  • Current stage: Reading files → Resolving anime on AniList → Resolving manga on AniList → Importing entries
  • Progress bar with current / total count
  • Name of the entry being processed
  • Live counters: imported, added to wishlist, updated, and (since v0.30.0) skipped, AniList unreachable

When AniList stops responding (since v0.30.0)

AniList limits how often you can ask it for data. If the importer hits that limit, the app waits the interval AniList asked for and tries again. Up to three attempts per group.

While waiting, the screen shows a stage like "AniList rate-limit reached, retrying in 47s (attempt 1/3)". The import counter stays in place.

If after three attempts some entries still couldn't be resolved, they go into a separate "skipped, AniList unreachable" counter. They are not placed in the Wishlist. Run the import again later, and those entries will pick up cleanly.

How matching works

For each MAL entry the importer asks AniList for the title with the matching MAL ID:

  1. If AniList returns an entry → it's saved to your library and added to the chosen collection
  2. If AniList has no record for that MAL ID → the entry goes to your Wishlist with a note containing status, score, tags, and comments

For entries with status Completed, episode/chapter/volume counters are filled in from AniList totals (or from the MAL XML if AniList doesn't know).

Re-importing the same list

The import screen has an Overwrite existing entries toggle (since v0.30.0). Off by default.

Off. Entries already in the collection stay as they are. Your status, rating, progress, dates, and comment are preserved. Only new entries from the file are added.

Handy when you keep editing values by hand in Tonkatsu Box and don't want a re-import to overwrite your changes.

On. Matched entries are updated from MAL data:

  • Status follows the standard rules (Completed and Dropped don't downgrade)
  • Progress takes the maximum of local and MAL value
  • Rating from MAL replaces yours if it's set
  • Earliest Started and latest Completed dates win
  • The user comment is rebuilt from the latest MAL data

Entries that land in the Wishlist get an automatic tag like "MyAnimeList, 2026-05-18 14:32". See the Wishlist page for filtering and bulk-removing a single import.

Tips

  • You can import only anime, only manga, or both at once
  • Re-import to refresh progress and dates after watching/reading more - existing items will be updated
  • If an entry didn't match on AniList, check the Wishlist - the MAL link is included so you can resolve it manually

🏠 Home


🇬🇧 English


🇷🇺 Русский


🇨🇳 中文


💬 Discord

Clone this wiki locally