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 folder.

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

If enabled, when processing files in your /downloads 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 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.

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}, {year}, {issue_number}, {issue_title}
Enter a pattern to see preview...
Examples:
• {series_name} {issue_number} ({year}) → Spider-Man 2099 044 (1992).cbz
• {series_name} [{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} ({year}) → Spider-Man 2099 044 - The Last Dance (1992).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/

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.

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.

Index & Sync Management

Manage the application's file search index stored in SQLite. The index provides fast searching across your entire library.

How it works: The file index is stored persistently in the database and automatically updates when you move, rename, or delete files. You can manually rebuild it or schedule automatic rebuilds to ensure data accuracy.

Index Status:
Checking...
Last Rebuild:
Checking...
Next Scheduled:
Not scheduled
Manually rebuild the entire file index. This scans all files in your data directory and updates the database. Use this if search results seem outdated.
Automatic Rebuild Schedule

Configure automatic file index rebuilds to keep your search results up-to-date.

How often the file index should automatically rebuild.
Time of day to run the rebuild (in your timezone).
Automatic Series Sync Schedule

Configure automatic syncing of tracked series from Metron API to check for new issues.

How often to sync series data from Metron API.
Time of day to run the sync (in your timezone).
GetComics Auto-Download Schedule

Automatically search GetComics for wanted issues (with today's release date or later) and queue downloads.

Weekly Packs Enabled: Individual issue auto-download is disabled because Weekly Packs is enabled. Manage Weekly Packs
How often to search GetComics for wanted issues.
Time of day to search and download (in your timezone).

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.

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
Slate
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