App Settings

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

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 Rename Pattern 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.
Use variables to create your naming pattern. Available variables: {series_name}, {volume_number}, {year}, {issue_number}
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

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.
Optional: Enter your PixelDrain API key for authenticated downloads. This enables access to private files and higher download limits.

Metadata API Configuration

Configure API keys for metadata providers to enrich your comics with detailed information.

Optional: Enter your ComicVine API key to enable metadata lookup from ComicVine. Get your API key at comicvine.gamespot.com/api
Comma-separated list of language codes for Grand Comics Database metadata (e.g., "en,es,fr"). Default: "en"
Optional: Enter your Metron credentials for metadata lookup. Get credentials at metron.cloud

Automatically rename files after metadata is fetched from the API.

Automatically move files to organized folders after metadata is fetched.
Define the folder structure for auto-moved files. 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/

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 (24-hour format).
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 (24-hour format).
GetComics Auto-Download Schedule

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

How often to search GetComics for wanted issues.
Time of day to search and download (24-hour format).

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
Default
Save settings to apply this theme.

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 config.ini.
Select the specific model to use.
Restart Flask App