stale-status

manifold mangadex stale-status [flags]

Scans your MangaDex library for titles whose latest uploaded chapter is older than a cutoff, then moves them to a target reading status (default on_hold). Dry-run until --apply.

Flags

--older-than <duration>

Select titles whose latest uploaded chapter is at least this old. Durations can be written as a number of days (90 or 90d), weeks (12w), months (6mo), or years (2y).

• Default: 365d

Example:

manifold mangadex stale-status --older-than 180d

--to <status>

Set stale titles to this MangaDex reading status. Valid statuses include reading, re_reading, on_hold, plan_to_read, completed, and dropped.

• Default: on_hold

Example:

manifold mangadex stale-status --to dropped

--from <statuses>

Limit changes to titles currently in one of these comma-separated MangaDex reading statuses.

• Default: reading,re_reading

Example:

manifold mangadex stale-status --from reading,on_hold

--apply

Write the target status to MangaDex. Without this flag, the command builds and reports a plan without changing your library.

• Default: false

Example:

manifold mangadex stale-status --older-than 180d --to on_hold --apply

--use-plan

Skip the scan and reuse .tmp/mangadex-stale-plan.json from the previous run. The command requires the relevant flags to match the saved plan.

• Default: false

Example:

manifold mangadex stale-status --use-plan --apply

--mangadex-client-id <id>

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

Example:

manifold mangadex stale-status --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 mangadex stale-status --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 mangadex stale-status --mangadex-username "$MANIFOLD_MANGADEX_USERNAME"

--mangadex-password <password>

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

Example:

manifold mangadex stale-status --mangadex-password "$MANIFOLD_MANGADEX_PASSWORD"

Usage

manifold mangadex stale-status
manifold mangadex stale-status --older-than 180d --to on_hold
bun run manifold mangadex stale-status --apply
bun run manifold mangadex stale-status --use-plan --apply

The first run builds a plan under .tmp/ (upload timestamps cached ~7 days). Large libraries take several minutes; requests are rate-spaced and retry on 429/5xx.