General Settings Library paths, file and folder naming, quality, scheduling, logging, backup, and maintenance options.
General settings control where Comicarr stores files, how it names them, and when background tasks run. Many options live in config.ini; the Settings → General page exposes content sources and naming-related UI controls. Library paths are typically shown read-only in the UI.
Setting Type Default Description DESTINATION_DIRstring — Root directory for your organized comic library. CACHE_DIRstring — Directory for temporary cache files (covers, API responses). GRABBAG_DIRstring — Directory for one-off or miscellaneous downloads. NEWCOM_DIRstring — Directory where newly downloaded comics land before processing.
In Docker, these paths refer to container-side mount points. Make sure the corresponding volumes are mapped in your docker-compose.yml.
Control which metadata providers are active. At least one source must be enabled.
Setting Section Type Default Description COMICVINE_ENABLED[CV]bool TrueEnable comic content via ComicVine. MANGADEX_ENABLED[MangaDex]bool TrueEnable manga content via MangaDex.
When a source is disabled, its search results, metadata features, and library UI elements are hidden. Enable both sources for a mixed comic and manga library. Disabling a source does not remove existing data — it only hides provider-specific functionality.
Setting Type Default Description FILE_FORMATstring $Series $Annual $Issue ($Year)Template for renaming comic files.
Setting Type Default Description FOLDER_FORMATstring $Series ($Year)Template for series directories.
Setting Type Default Description ARC_FOLDERFORMATstring $arc ($spanyears)Template for story arc directories.
Token Description Example $SeriesSeries name Amazing Spider-Man$IssueIssue number (zero-padded per ZERO_LEVEL) 001$YearPublication year 2024$AnnualResolves to Annual when the issue is an annual, empty otherwise Annual$MonthlyResolves to the month name for monthly issues January$PublisherPublisher name Marvel$ImprintPublisher imprint MAX Comics$TypeSeries type (e.g. Trade Paperback, Hard-Cover) TPB$arcStory arc name (arc folders only) Secret Wars$spanyearsYear range the arc spans (arc folders only) 2015-2016
Setting Type Default Description REPLACE_SPACESbool FalseReplace spaces in filenames with REPLACE_CHAR. REPLACE_CHARstring — Character used when REPLACE_SPACES is enabled (often _ or . when set). ZERO_LEVELbool FalseEnable zero-padding of issue numbers. ZERO_LEVEL_Nstring — Padding width when ZERO_LEVEL is enabled. LOWERCASE_FILENAMESbool FalseForce all filenames to lowercase.
Configured under Settings → Search for the UI-exposed filters, or in config.ini.
Setting Type Default Description PREFERRED_QUALITYint 0Preferred release quality: 0 = any, 1 = HD, 2 = Web-DL. MINSIZEstring — Minimum file size in MB when USE_MINSIZE is enabled. MAXSIZEstring — Maximum file size in MB when USE_MAXSIZE is enabled. USE_MINSIZEbool FalseEnable the minimum size filter. USE_MAXSIZEbool FalseEnable the maximum size filter.
All intervals are in minutes unless noted otherwise.
Setting Type Default Description RSS_CHECKINTERVALint 20Minutes between RSS feed checks. SEARCH_INTERVALint 1440Minutes between full search sweeps (default is 24 hours). DOWNLOAD_SCAN_INTERVALint 5Minutes between download client status polls. CHECK_GITHUB_INTERVALint 360Minutes between update checks against the GitHub repository.
Setting RSS_CHECKINTERVAL or SEARCH_INTERVAL too low may cause you to hit provider rate limits. The defaults are safe for most setups.
Setting Type Default Description LOG_DIRstring — Directory for log files. Defaults to <config_dir>/logs. MAX_LOGSIZEint 10000000Maximum log file size in bytes (~10 MB). MAX_LOGFILESint 5Number of rotated log files to keep. LOG_LEVELint 1Verbosity: 1 = INFO; ≥2 = DEBUG (see logger.py).
Setting Type Default Description BACKUP_ON_STARTbool FalseCreate a backup of the database and config each time Comicarr starts. BACKUP_LOCATIONstring — Directory for backup files. Defaults to <config_dir>/backups. BACKUP_RETENTIONint 4Number of backup copies to retain. Older backups are deleted automatically.
Setting Type Default Description CLEANUP_CACHEbool FalsePeriodically remove stale cache files. CLEANUP_STRAYSbool FalseRemove orphaned files that no longer belong to a monitored series.