Filters#

Currently filters can be used in:

  • Search manga (mangadex-dl "title manga" -s)

  • Random manga (mangadex-dl "random")

Syntax#

It’s accesible from -ft or --filter option

mangadex-dl -s -ft "KEY=VALUE"

It also support multiple values separated by commas

mangadex-dl "random" -ft "KEY=VALUE1,VALUE2,VALUE3"

Note

random manga has limited filters, here a list of available filters for random manga.

  • content_rating

  • included_tags

  • included_tags_mode

  • excluded_tags

  • excluded_tags_mode

Available filters#

authors [VALUE1, VALUE2, ...]#

Authors of manga

Value must be valid uuid or MangaDex url containing uuid.

artists [VALUE1, VALUE2, ...]#

Artists of manga

Value must be valid uuid or MangaDex url containing uuid.

author_or_artist [VALUE]#

An Author OR an Artist within Manga

Value must be valid uuid or MangaDex url containing uuid.

year [INTEGER]#

Year of release

included_tags [VALUE1, VALUE2, ...]#

Value must be valid keyword or uuid or MangaDex url containing uuid. To see all available tags in MangaDex -> https://mangadex.org/tag/

included_tags_mode [OR, AND]#
excluded_tags [VALUE1, VALUE2, ...]#

Value must be valid keyword or uuid or MangaDex url containing uuid. To see all available tags in MangaDex -> https://mangadex.org/tag/

excluded_tags_mode [OR, AND]#
status [VALUE1, VALUE2, ...]#

Must be one of:

  • ongoing

  • completed

  • hiatus

  • cancelled

original_language [VALUE1, VALUE2, ...]#

Must be one of valid languages returned from mangadex-dl --list-languages

excluded_original_language [VALUE1, VALUE2, ...]#

Must be one of valid languages returned from mangadex-dl --list-languages

available_translated_language [VALUE1, VALUE2, ...]#

Must be one of valid languages returned from mangadex-dl --list-languages

publication_demographic [VALUE1, VALUE2, ...]#

Must be one of:

  • shounen

  • shoujo

  • josei

  • seinen

  • none

content_rating [VALUE1, VALUE2, ...]#

Must be one of:

  • safe

  • suggestive

  • erotica

  • pornographic

created_at_since [DATETIME]#

value must matching format %Y-%m-%dT%H:%M:%S

updated_at_since [DATETIME]#

value must matching format %Y-%m-%dT%H:%M:%S

has_available_chapters [1 or 0, true or false]#
order[title] [asc or ascending, desc or descending]#
order[year] [asc or ascending, desc or descending]#
order[createdAt] [asc or ascending, desc or descending]#
order[updatedAt] [asc or ascending, desc or descending]#
order[latestUploadedChapter] [asc or ascending, desc or descending]#
order[followedCount] [asc or ascending, desc or descending]#
order[relevance] [asc or ascending, desc or descending]#
order[rating] [asc or ascending, desc or descending]#

Example usage#

Search manga with content rating erotica and status completed

mangadex-dl -s -ft "original_language=Japanese" -ft "content_rating=erotica" -ft "status=completed"

Search manhwa with “highest rating” order

mangadex-dl -s -ft "original_language=Korean" -ft "order[rating]=descending"

Random manga with oneshot tags but without yuri and yaoi tags

mangadex-dl "random" -ft "included_tags=oneshot" -ft "excluded_tags=boys' love, girls' love"