anilist-to-mangadex

manifold migrate anilist-to-mangadex [flags]

Fetches your AniList manga list, matches titles on MangaDex, then sets reading status and optionally marks chapters up to AniList progress. Runs entirely locally because AniList blocks Cloudflare Worker IPs.

Flags

--anilist-token <token>

Optional AniList access token override. Resolve order: flag → MANIFOLD_ANILIST_TOKEN → login anilist keychain.

Example:

manifold login anilist
manifold migrate anilist-to-mangadex

--apply

Write statuses and chapter read markers to MangaDex. Without this flag, the command only reports what it would change.

• Default: false

Example:

manifold migrate anilist-to-mangadex --apply

--skip-progress

Update reading statuses but do not backfill MangaDex chapter read markers from AniList progress.

• Default: false

Example:

manifold migrate anilist-to-mangadex --skip-progress

--mangadex-client-id <id>

OAuth client ID for the MangaDex password grant. Falls back to MANIFOLD_MANGADEX_CLIENT_ID.

Example:

manifold migrate anilist-to-mangadex --mangadex-client-id "$MANIFOLD_MANGADEX_CLIENT_ID"

--mangadex-client-secret <secret>

OAuth client secret for the MangaDex password grant. Falls back to MANIFOLD_MANGADEX_CLIENT_SECRET.

Example:

manifold migrate anilist-to-mangadex --mangadex-client-secret "$MANIFOLD_MANGADEX_CLIENT_SECRET"

--mangadex-username <username>

MangaDex account username for the password grant. Falls back to MANIFOLD_MANGADEX_USERNAME.

Example:

manifold migrate anilist-to-mangadex --mangadex-username "$MANIFOLD_MANGADEX_USERNAME"

--mangadex-password <password>

MangaDex account password for the password grant. Falls back to MANIFOLD_MANGADEX_PASSWORD.

Example:

manifold migrate anilist-to-mangadex --mangadex-password "$MANIFOLD_MANGADEX_PASSWORD"

All four MangaDex credential flags are required together. This command accepts the OAuth password grant only; it does not accept a MangaDex personal token.

Matching and status map

Per AniList entry:

1. MangaDex links.al direct hit
2. Normalized title search

AniList → MangaDex status mapping:

Chapter backfill marks read every chapter numbered up to the AniList progress value (unless --skip-progress).

Workflow

manifold migrate anilist-to-mangadex
manifold migrate anilist-to-mangadex --apply

Unmatched titles and per-title failures leave a non-zero exit code. Prefer a dry-run first on a large list. Secrets live in cli/.env — see cli/.env.example.