Skip to content

AniList Import

hcan359 edited this page May 18, 2026 · 3 revisions

AniList Import

Import your AniList anime and manga lists by public username - no API key, no OAuth.

What gets imported

AniList field Tonkatsu Box
Media id External id linked to the AniList entry
Media type (ANIME / MANGA) Anime / Manga item
status Item status (see status mapping)
score (1-100) User rating, normalised to 1-10 (score 0 becomes "no rating")
progress Current episode (anime) or current chapter (manga)
progressVolumes Current volume (manga)
repeat Rewatch / reread count (added to the user comment)
notes Appended to the user comment
startedAt / completedAt Started / Completed dates (year/month/day fuzzy dates supported)
updatedAt Last activity timestamp

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

isAdult entries are skipped. Entries from custom lists are skipped because AniList places them in the canonical list as well - they'd be duplicates.

Status mapping

AniList status Tonkatsu Box status
CURRENT In Progress
REPEATING In Progress (repeat count saved in the comment)
COMPLETED Completed (episode / chapter / volume counters topped up to AniList totals)
PLANNING Planned
DROPPED Dropped
PAUSED Dropped

Requirements

  • No API key, no OAuth - the importer reads your public AniList profile.
  • Internet connection - single GraphQL request per list type (one for anime, one for manga).
  • The profile must be public; private profiles will fail with a clear error message.

How to import

  1. Open Settings → Import → AniList
  2. Enter your AniList username (the importer remembers it for next time)
  3. Choose which lists to pull:
    • Anime list and/or Manga list (at least one must be selected)
  4. Pick a mode:
    • Add new only - skip items already in the target collection
    • Overwrite existing - update status, progress, rating, dates from AniList
  5. Choose target collection:
    • Create new collection - names the collection AniList Import - <username> by default
    • Use existing collection - pick one from the dropdown
  6. Tap Start Import

Import progress

While importing you'll see:

  • Current stage: Fetching anime list → Fetching manga list → Importing entries
  • Progress bar with current / total
  • Name of the entry being processed
  • Live counters: imported, updated

How COMPLETED top-up works

For entries marked COMPLETED, the importer fills in counters and dates to reflect a finished status:

  • Anime: episode counter is set to max(progress, anime.episodes)
  • Manga: chapter counter is set to max(progress, manga.chapters), volume counter to max(progressVolumes, manga.volumes)
  • Dates: if completedAt is missing it falls back to startedAt then updatedAt; if startedAt is missing it falls back to completedAt

For other statuses, counters and dates are taken as-is.

Duplicate handling

Re-importing into the same collection in Overwrite mode updates existing items rather than duplicating them:

  • Status - merged via the standard external-status rules (never downgrades Completed or Dropped)
  • Progress - max(local, AniList) for episodes / chapters / volumes
  • Rating - AniList score wins when set
  • Dates - earliest Started, latest Completed
  • User comment - rebuilt from fresh AniList data (link, repeat count, notes)

In Add new only mode existing items are skipped.

Tips

  • The username is stored locally and pre-filled on the next visit. It's never sent anywhere except to AniList.
  • Re-import in Overwrite mode to refresh progress and dates after you've watched / read more.
  • If the same media appears in different collections, each collection tracks its own progress - only the collection you selected for the import is updated.

🏠 Home


🇬🇧 English


🇷🇺 Русский


🇨🇳 中文


💬 Discord

Clone this wiki locally