The config module centralizes all configuration settings for the Universal Manga Downloader. It loads environment variables and defines constants used throughout the application.
Environment loading
The module uses python-dotenv to load environment variables from a .env file:
from dotenv import load_dotenv
load_dotenv()
API keys and tokens
GOOGLE_API_KEY
API key for Google services integration. Loaded from the GOOGLE_API_KEY environment variable.
GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
[WARN] GOOGLE_API_KEY not found in .env
DISCORD_TOKEN
Optional Discord bot token for Discord integration features.
DISCORD_TOKEN = os.getenv("DISCORD_TOKEN")
HEADLESS
Controls whether Playwright browsers run in headless mode. Not defined in config.py but read directly in site handlers.
# Used in hitomi.py and nhentai.py
is_headless = os.getenv("HEADLESS", "false").lower() == "true"
"true" to run browsers without a visible window. Defaults to "false".
Browser identity
USER_AGENT
User agent string used to identify the downloader as a standard web browser. This helps bypass basic bot detection:
USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
HEADERS_TMO = {
"Referer": "https://tmohentai.com/",
"User-Agent": USER_AGENT
}
HEADERS_M440 = {
"Referer": "https://m440.in/",
"User-Agent": USER_AGENT
}
HEADERS_H2R = {
"Referer": "https://hentai2read.com/",
"User-Agent": USER_AGENT
}
HEADERS_HITOMI = {
"Referer": "https://hitomi.la/",
"User-Agent": USER_AGENT
}
HEADERS_ZONATMO = {
"Referer": "https://zonatmo.com/",
"User-Agent": USER_AGENT
}
HEADERS_NHENTAI = {
"User-Agent": USER_AGENT
}
Folder names
PDF_FOLDER_NAME
Name of the directory where generated PDF files are saved:
TEMP_FOLDER_NAME
Name of the temporary directory used for downloading images before PDF compilation:
TEMP_FOLDER_NAME = "temp_manga_images"
Download settings
BATCH_SIZE
Number of images to download concurrently in each batch. Controls the parallelism of image downloads:
Higher values increase download speed but consume more memory and network resources.
DEFAULT_PAGE_COUNT
Default expected page count for manga chapters when the actual count is unknown:
Runtime flags
OPEN_RESULT_ON_FINISH
Boolean flag controlling whether to automatically open the PDF file and its containing folder after successful generation:
OPEN_RESULT_ON_FINISH = True
True: Automatically opens the PDF folder and file (Windows only)False: Completes silently without opening files
Modifying configuration at runtime
You can modify configuration values at runtime by importing and reassigning them:
from core import config
# Change batch size for faster downloads
config.BATCH_SIZE = 20
# Disable automatic file opening
config.OPEN_RESULT_ON_FINISH = False
# Use custom folder names
config.PDF_FOLDER_NAME = "downloads/manga"
config.TEMP_FOLDER_NAME = "temp_downloads"
Changes to configuration values only affect operations that occur after the modification. Already-running downloads will use the original values.
Usage example
from core.config import (
HEADERS_TMO,
PDF_FOLDER_NAME,
BATCH_SIZE,
OPEN_RESULT_ON_FINISH
)
# Use headers for requests
import aiohttp
async with aiohttp.ClientSession(headers=HEADERS_TMO) as session:
async with session.get(url) as response:
content = await response.read()
# Construct output path
import os
output_path = os.path.join(os.getcwd(), PDF_FOLDER_NAME, "manga.pdf")
# Use batch size for concurrent downloads
for i in range(0, len(urls), BATCH_SIZE):
batch = urls[i:i+BATCH_SIZE]
# Process batch...