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. All options are on the Settings > General page.
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.
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. ZERO_LEVELint 0Number of digits to zero-pad issue numbers to. 0 disables padding. LOWERCASE_FILENAMESbool FalseForce all filenames to lowercase.
Setting Type Default Description PREFERRED_QUALITYstring — Preferred release quality when multiple results match. MINSIZEint 0Minimum file size in bytes. Releases below this are skipped. MAXSIZEint 0Maximum file size in bytes. Releases above this are skipped. 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: 0 = INFO, 1 = DEBUG, 2 = WARNING.
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.