Weekly Pull List

Track new comic releases each week, auto-add series, and organize files into weekly folders.

The weekly pull list shows upcoming comics from the Previews catalog, letting you track new releases and automatically add series to your library.

Pull List Modes

The ALT_PULL setting controls how Comicarr retrieves the weekly pull list:

ValueModeDescription
1DirectFetches the pull list directly from the source.
2AlternateUses an alternate retrieval method (default).

The pull list refreshes automatically based on PULL_REFRESH. You can force a refresh from the Weekly Pull List page.

Publisher Filtering

The pull list is organized by publisher groups. Each group has a visibility weight that controls display priority:

PublisherConfig KeyDefault Weight
DC ComicsBIGGIE_PUB55
MarvelBIGGIE_PUB55
Dark HorseINDIE_PUB75
ImageINDIE_PUB75
Indies (all others)INDIE_PUB75

Use MASS_PUBLISHERS to specify which publishers appear in the mass-add view.

Auto Mass-Add

Enable AUTO_MASS_ADD (default: False) to automatically add new series that appear on the pull list to your library. This is useful for readers who want everything from specific publishers.

Auto mass-add can add a large number of series quickly. Use publisher filtering to limit which series are added, or you may end up monitoring hundreds of unwanted titles.

Weekfolder Management

Organize downloaded comics into weekly folders for easy browsing.

SettingDefaultDescription
WEEKFOLDERFalseEnable weekly folder organization.
WEEKFOLDER_LOCNoneDirectory where weekly folders are created.
WEEKFOLDER_FORMAT0Folder naming format (date-based).

When enabled, comics that appear on the current week's pull list are copied or linked into a folder named after that week's date, giving you a "new this week" view.

Special Issue Detection

The pull list identifies special issue types and handles them appropriately:

CodeTypeDescription
HCHardcoverCollected hardcover editions
TPTrade PaperbackCollected trade paperback editions
GNGraphic NovelOriginal graphic novels
SCSoftcoverSoftcover collected editions
ONE SHOTOne ShotSingle standalone issues

Use FORMAT_BOOKTYPE to control how these special types appear in the UI and file naming.

Substitution CSV

Comicarr supports a substitution CSV file for title replacements. This is useful when:

  • Provider listings use abbreviated or alternate names
  • Series names differ between the pull list and ComicVine
  • You want to normalize titles across sources

The CSV maps pull list titles to the names Comicarr should use for matching and searching.

Pack and Watchlist

PACK_0DAY_WATCHLIST_ONLY (default: True) -- when processing day-zero packs from providers, only grab issues for series already on your watchlist. Disable to grab everything in the pack.

On this page