App Settings

Comic Libraries

Configure your comic library locations. Each library can have a custom name and path.

Loading libraries...
Note: For libraries, you must first add the volume mapping in your Docker configuration (e.g., /e/Manga:/manga), then add the library path here (e.g., /manga).

Folder Monitoring

Configure the Watched and Target folders. Other monitoring features can be adjusted here as well.

Enter the path to the directory to monitor for downloaded files.
Enter the path where renamed files will be moved.

Enables auto-conversion of CBR/RAR files to CBZ in your Watch folder.

If enabled, the app will process files in sub-directories of your /downloads/temp folder.

When enabled, ZIP files placed in the Watch folder will automatically be unzipped.

If enabled, when processing files in your /downloads/temp folder, the sub-dirctories will be moved as well.

When a downloaded directory contains only one file, consolidate it into a series folder by stripping the issue number from the directory name. (e.g., PEP Comics 140/ → PEP Comics/)

When enabled, files will be automatically renamed using the built-in naming rules when moved from your /downloads/temp folder.
Enter extensions to ignore when monitoring files (e.g., .tmp, .crdownload).

Automatically removes temporary download files (.crdownload, .tmp, .part) from the downloads folder.
How often to automatically clean up orphan files (1-24 hours).
Trash Can
Move deleted files to trash instead of permanently deleting them.
Leave empty to use default (/cache/trash).
Oldest items are automatically evicted when this limit is reached.

Directory & File Processing Settings

Settings related to Directory processing features.


If enabled, when performing CBR --> CBZ conversion on a directory, CLU will convert all files in subdirectories as well.

Settings related to Directory & File processing features.

When any operation unpacks a RAR/ZIP File, files with these extensions will be skipped. They will be re-added to the archive.
When any operation unpacks a RAR/ZIP File, files with these extensions will deleted before the file is re-packed.
Comma-separated list of directory names to hide from all views (e.g., @eaDir). Common NAS system directories like @eaDir are hidden by default.

Custom Naming Settings

Configure custom patterns for renaming comic files. You can use variables to create your own naming convention, or leave empty to use the default rename logic.


If enabled, files will be renamed using your custom pattern instead of the default rename logic.

Automatically rename files after metadata is fetched from the API.
Use variables to create your naming pattern. Available variables: {series_name}, {volume_number}, {volume_year} (series/volume start year), {issue_year} (this issue's year), {issue_number}, {issue_title}. Cover/store dates (from ComicVine/Metron): {cover_year}, {cover_month_M} (June), {cover_month_m} (06), {store_year}, {store_month_M}, {store_month_m}
Enter a pattern to see preview...
Examples:
• {series_name} {issue_number} ({volume_year}) → Spider-Man 2099 044 (1992).cbz
• {series_name} [{volume_year}] {issue_number} → Spider-Man 2099 [1992] 044.cbz
• issue{issue_number} → issue001.cbz
• {volume_number}_{issue_number} → v2_044.cbz
• {series_name} {issue_number} - {issue_title} ({volume_year}) → Spider-Man 2099 044 - The Last Dance (1992).cbz
• {series_name} {issue_number} ({cover_year}-{cover_month_m}) → Spider-Man 2099 044 (1992-06).cbz
Define the folder structure to use when adding series to your Pull List. Available variables: {publisher}, {series_name}, {volume_number}, {start_year}, {issue_number}
Enter a pattern to see preview...
Examples:
• {publisher}/{series_name}/v{start_year} → Marvel/Spider-Man 2099/v1992/
• {publisher}/{series_name} → Marvel/Spider-Man 2099/
• {series_name} [{start_year}] → Spider-Man 2099 [1992]/
• {publisher}/{volume_number} → Marvel/v2/
Smart Rename

Renames files using values from series.json and the issue number parsed from each filename, instead of regex-matching the whole name. Available from the folder three-dots menu on the Files page.

Show a modal of planned renames and require Apply before any file is touched. Turn off to rename immediately on click.
Walk subdirectories and process each one that has its own cvinfo/series.json.
Case-insensitive substring match against the filename. Useful when Annuals/Specials share a folder with the main series — they have their own issue numbering and shouldn't be renamed onto the main slots. Leave blank to skip nothing.
Filename Character Cleanup

Apply after pattern substitution to every rename (custom and default logic). The file extension is always preserved.

Example: Batman 001 → Batman_001
Each character is treated literally, not as regex.
Replacements cannot contain Windows-reserved characters: < > : " / \ | ? *

API Download Configuration

These options, along with the Chrome extension, will let you `right-click` links and send them to CLU to be downloaded to your /watch folder.

Similar to the Chrome Extension, enter any authentication details here that need to be passed to your URL/domain/Tunnel/VPN.

Download Provider Priority

Set the order CLU tries download providers from GetComics. If a provider fails or its link isn't available, CLU tries the next one.

Optional: Enter your PixelDrain API key for authenticated downloads. This enables access to private files and higher download limits.
PixelDrain is a recommended service. $10 of Pre-Paid service should easily last you all year and you'll see download speed improvements with 5GB downloads in a matter of minutes.

Search Variant Settings

Configure how GetComics handles different publication types and format variants during search matching.

Publication types that create different series (e.g., "Batman Annual" is different from "Batman"). Comma-separated list.
Format variants that can be optionally accepted when searching (e.g., TPB, Omnibus, Hardcover editions). Comma-separated list.
Folder names whose files are unrelated single issues (e.g., one-shots). In bulk metadata, each file in these folders is matched individually from its own filename and no cvinfo/series.json is written. Comma-separated, matched by folder name.

GetComics Wanted Issues Simulation

Simulate the full wanted-issues search across all tracked series. Shows exactly what would be searched, found, scored, and downloaded — without making any actual downloads.

Run simulation for a specific series only

Client API Access

Generate a long-lived bearer token for the offline mobile/desktop reader app. The client sends it as Authorization: Bearer <token> on every request to /api/v1/*.

Not Configured
Treat this token like a password. Anyone with it can read your library and reading progress over /api/v1/*. Rotate it to revoke access from old clients.

Controls how the offline reader navigates your library. Clients can override per request with ?mode=metadata or ?mode=filesystem.

Metadata view groups by publisher / series read from each file's ComicInfo.xml. Filesystem view mirrors the folders under your data directory — same as the main /collection browser.

Komga Reading Sync

Sync reading history and progress from your Komga server to CLU.

Not Configured
Full URL to your Komga server (e.g., http://192.168.1.100:25600)
Library Path Mapping

Map each CLU library to its corresponding Komga path prefix. Leave the Komga path empty to skip a library during sync.

Loading libraries...

Sync Schedule

Provider Credentials

Configure API credentials for metadata providers. Credentials are stored encrypted.

Loading providers...

Library Provider Settings

Configure which metadata providers to use for each library and their priority order.

Loading library settings...

Performance & Timeout Settings

Configure timeout settings for large file operations and performance optimizations.

Timeout for large file operations (convert, rebuild). Default: 3600 seconds (1 hour). Minimum: 300 seconds (5 minutes).
Files larger than this size (in MB) will get enhanced progress reporting. Default: 500 MB.

Timezone Settings

Set your local timezone for accurate reading history tracking.

Affects how reading history dates are displayed on the Insights page.

Cache Management

Clear cached data to refresh statistics and file listings.

Clears directory cache and statistics cache (Insights charts). Use this if data appears stale.

Missing Issue Configuration

Update these settings to ignore terms or files when the app is performing a Missing Issue scan.

Enter words or terms to ignore while performing a Missing Issue search. Terms must be comma-separated.
Enter comma-separated file names to ignore when checking for missing issues (e.g., cover.jpg, cvinfo).

Logging & Debugging

Configure application logging settings. Debug logging provides detailed diagnostic information useful for troubleshooting.


When enabled, detailed debug messages will appear in the App Logs. This can help with troubleshooting but may increase log file size. Changes take effect after saving.

ComicInfo.XML Update Settings

Enable/Disable features for updating or cleaning ComicInfo.xml files. This proecess runs on a single directory, extracts the ComicInfo.xml file, reads and makes updates and then recompresses the file.


Reads the alpha-numeric first file in the directory and attempts to extract the 4-digit year from the filename.

If enabled, when the ComicInfo.xml update function is run, the Comments will have all headers, bold text and tables removed.

If enabled, when the ComicInfo.xml update function is run, 'Covers & Creators' tables will be removed from the Comments.

Current Database

SQLite file size and row counts per table.

Path: –
DB size: –
WAL / SHM: –
Tables: –
Total rows: –
TableRows
Loading…

Backups

Auto-created on container start (when the DB has changed). Up to 3 retained, plus any manual or pre-restore snapshots.

Last backup: –
Filename Created Size Action
Loading…
Restoring replaces the current database. A safety snapshot of the current DB is taken automatically just before restore. Restart the app after restoring to ensure all background workers reload state.

Theme Selection

Choose a Bootstrap theme for the application. Themes provided by Bootswatch.

Select a theme to change the look and feel of the application. Dark themes are marked.
Theme preview
Default
Save settings to apply this theme.

Dashboard Layout

Configure which sections appear on your collection dashboard and their display order.

  • Favorite Collections
  • Want to Read
  • Continue Reading
  • On the Stack
  • Discover / Recommendations (Also requires Recommendations enabled)
  • Recently Added
  • Library
Changes take effect on the collection/home page after saving.

Recommendation Service

Configure AI-powered recommendations for your reading list. Requires an API key from your preferred provider.

Select the AI service provider.
Your API key is stored locally in the application database.
Select the specific model to use.
Restart Flask App