Configuration

These configs automatically written into command-line options value, so you don’t have to write a bunch command line options. Just set a config and the app will automatically set the value to command-line options.

Still confused how is it working ? see this example

Let’s say you want to download a manga with

  • Forced HTTPS port

  • No progress bar

  • Using DNSOverHTTPS to cloudflare

  • No manga cover

  • No group name in each chapters

  • And the chapters language must Indonesian

  • And store it to library directory

The results:

mangadex-dl "https://mangadex.org/title/..." --force-https --progress-bar-layout "none" --dns-over-https "cloudflare" --cover "none" --no-group-name --language "Indonesian" --path "library/mymanga"

It is wayyyy too longgggggg and you have to write these command-line options everytime to download manga. How to fix this ? Config is the only answer !

First, enable config first.

# `1` is alias for True and `0` is alias for False

# For Windows
set MANGADEXDL_CONFIG_ENABLED=1

# For Linux / Mac OS
export MANGADEXDL_CONFIG_ENABLED=1

Note

Keep in mind this is for current session console only. If you want to set it permanently, change the user environment variables.

Second, set the values for configs

# `1` is alias for True and `0` is alias for False
mangadex-dl "conf:force_https=1"
mangadex-dl "conf:progress_bar_layout=none"
mangadex-dl "conf:dns_over_https=cloudflare"
mangadex-dl "conf:cover=none"
mangadex-dl "conf:no_group_name=1"
mangadex-dl "conf:language=Indonesian"
mangadex-dl "conf:path=library/mymanga"

After that you can download the manga without writing very-very long command-line options

mangadex-dl "https://mangadex.org/title/..."

But, i don’t want type all those commands. I just want single command, just type the file that i have every configs that i wanna change and it changed.

Well, you can do it too. But, this time we’re using -pipe option.

Let’s say you have config.txt. And inside of that file is that every configs that you wanna change.

conf:force_https=1
conf:progress_bar_layout=none
conf:dns_over_https=cloudflare
conf:cover=none
conf:no_group_name=1
conf:language=Indonesian
conf:path=library/mymanga

And then you execute these commands:

# For Windows
type config.txt | mangadex-dl -pipe

# For Linux / Mac OS
cat config.txt | mangadex-dl -pipe

Horray ! your configs is now changed.

Syntax

mangadex-dl "conf:KEY=VALUE"

Environment variables

MANGADEXDL_CONFIG_ENABLED [1 or 0, true or false]

Set this 1 or true to enable config, 0 or false to disable config.

MANGADEXDL_CONFIG_PATH

A directory to store config and authentication cache.

Available configs

login_cache [1 or 0, true or false]

Same as --login-cache

language

Same as --language or -lang

cover

Same as --cover or -c

save_as

Same as --save-as or -f

use_chapter_title [1 or 0, true or false]

Same as --use-chapter-title or -uct

use_compressed_image [1 or 0, true or false]

Same as --use-compressed-image or -uci

force_https [1 or 0, true or false]

Same as --force-https or -fh

path

Same as --path or --folder or -d

filename_chapter

Same as --filename-chapter or -fc

filename_volume

Same as --filename-volume or -fv

filename_single

Same as --filename-single or -fs

dns_over_https

Same as -doh or --dns-over-https

no_group_name

Same as -ngn or --no-group-name

sort_by

Same as --sort-by

http_retries

Same as --http-retries

no_track

Same as --no-track

download_mode

Same as --download-mode

download_mode

Same as --download-mode

use_chapter_cover [1 or 0, true or false]

Same as --use-chapter-cover

use_volume_cover [1 or 0, true or false]

Same as --use-volume-cover

volume_cover_language

Same as --volume-cover-language

stacked_progress_bar_order

Same as --stacked-progress-bar-order

log_level

Same as --log-level

progress_bar_layout

Same as --progress-bar-layout

ignore_missing_chapters [1 or 0, true or false]

Same as --ignore-missing-chapters

create_no_volume [1 or 0, true or false]

Same as --create-no-volume

create_manga_info [1 or 0, true or false]

Same as --create-manga-info

manga_info_format

Same as --manga-info-format

manga_info_filepath

Same as --manga-info-filepath

manga_info_only [1 or 0, true or false]

Same as --manga-info-only

no_metadata [1 or 0, true or false]

Same as --no-metadata

page_size

Same as --page-size

order

Same as --order

group_nomatch_behaviour

Same as --group-nomatch-behaviour

reset [config]

Reset config back to default value

Example usage

Enable config

# For Windows
set MANGADEXDL_CONFIG_ENABLED=1

# For Linux / Mac OS
export MANGADEXDL_CONFIG_ENABLED=1

Change directory stored config to another path

# For Windows
set MANGADEXDL_CONFIG_PATH=D:\myconfig\here\lmao

# For Linux / Mac OS
export MANGADEXDL_CONFIG_PATH="/etc/mangadex-dl/config"

Set a config

mangadex-dl "conf:save_as=pdf"
# Successfully changed config save_as from 'raw' to 'pdf'

mangadex-dl "conf:use_chapter_title=1"
# Successfully changed config use_chapter_title from 'False' to 'True'

Reset a config back to default value

mangadex-dl "conf:reset=save_as"
# Successfully reset config 'save_as'