Export your entire MangaDex library — with scores, statuses, and chapter history — to MyAnimeList and AniList. Import back in one click.
Dump your full library to JSON, MAL XML, or AniList XML with scores and statuses
Restore from any backup file or migrate from a MAL/AniList export
Generate MAL XML, AniList XML, and .gz from a single export in one click
Export titles and statuses in minutes. Perfect for a quick snapshot without waiting on chapter history.
Also fetches your last-read chapter per manga. Takes 15–60+ min depending on library size, but captures everything.
Carries your MangaDex ratings across to MAL and AniList — not just status. Your scores travel with you.
Interrupted mid-export? No problem. Re-run and it picks up from the last checkpoint automatically.
Preview exactly what would happen during an import without touching your account. Safe to test.
Opens in a native window via pywebview. Falls back to your browser automatically if pywebview isn't available.
Logs every export with timestamp and a list of generated files, so you always know what you have.
Import from a JSON backup, a MAL XML file, or an AniList XML file. Handles all three formats natively.
Install with pip install mangadex-sync and run from anywhere — no cloning required.
pip install mangadex-sync
mangadex-sync
Opens at localhost:7337 in a native window (or browser fallback).
git clone https://github.com/Spider2742/mangadex-sync
cd mangadex-sync
pip install -r standalone/requirements.txt
python standalone/mangadex_sync.py
Free to create — approved instantly, no waiting.
| File | Description |
|---|---|
| mdex_{status}_{ts}.json | Full JSON backup — used by the Import tab to restore |
| mdex_{status}_{ts}.xlsx | Raw data spreadsheet — used by the Convert tab |
| mal_{status}_{ts}.xml | MAL import file — upload directly to MyAnimeList |
| mal_{status}_{ts}.xml.gz | Compressed MAL file — also accepted by MAL's importer |
| anilist_{status}_{ts}.xml | AniList import file — upload to AniList's import tool |
Check your Client ID, Client Secret, username, and password. Make sure the API client isn't still in Pending state on mangadex.org/settings.
Your API client was likely deleted or has expired approval. Go back to MangaDex settings and verify it's active.
The app falls back to your browser automatically. On Linux, it will print the exact system package command needed for your distro to enable the native window.
Those titles had no MAL/AniList ID on MangaDex and are listed in the Skipped section. You'll need to add them manually.