Adding Series
Search for comic series via ComicVine, configure quality preferences, and start monitoring for new issues.
Comicarr uses ComicVine as its primary metadata source for discovering and tracking comic series.
Searching for Series
Open the Add Series page
Navigate to Comics > Add a Comic or use the search bar in the top navigation.
Enter a search term
Type the series name and press Enter. Comicarr queries the ComicVine API and returns matching results with cover art, publisher, year, and issue count.
Select and add
Click the series you want to add. Comicarr creates a folder in your library directory, pulls metadata for all known issues, and begins monitoring.
ComicVine API calls are rate-limited to 2 requests per second (CVAPI_RATE). Large searches may take a moment.
Alternative Search Terms
If the default name does not return good download results, you can set an alternative search term on the series detail page. This overrides the series name used when searching providers, without changing the display name or folder name.
Quality Preferences
Control what Comicarr considers an acceptable download.
| Setting | Config Key | Description |
|---|---|---|
| Preferred Quality | PREFERRED_QUALITY | 0 = any format. Higher values prefer specific qualities. |
| Minimum Size | USE_MINSIZE / MINSIZE | Reject files smaller than this threshold (in MB). |
| Maximum Size | USE_MAXSIZE / MAXSIZE | Reject files larger than this threshold (in MB). |
Setting size limits too aggressively can cause valid releases to be skipped. Start without limits and tighten gradually based on what your providers return.
Monitoring for New Issues
Once a series is added, Comicarr automatically:
- Marks upcoming issues as Wanted
- Checks RSS feeds every 20 minutes for new releases
- Runs a full provider search every 1440 minutes (24 hours)
You can control auto-wanting behavior with:
AUTOWANT_UPCOMING(default:True) -- automatically want future issues as they appear in ComicVine.AUTOWANT_ALL(default:False) -- want all existing back issues when adding a series.
Annual Series
Comicarr can track annual companion series (e.g., "Batman Annual") alongside the main series.
- Enable with
ANNUALS_ONin General settings. - Annuals are matched to their parent series and stored in the same library folder.
- The
$Annualtoken in file/folder format strings controls how annual issues are named.
When enabled, adding "Batman" also pulls metadata for "Batman Annual" and treats those issues as part of the same series.
Ignored Publishers
Use IGNORED_PUBLISHERS in the CV settings to exclude publishers you never want to see in search results. This reduces noise when common series names overlap across publishers.