Weekly Pull List
Track new comic releases each week, auto-add series, and organize files into weekly folders.
The weekly pull list surfaces the current week’s releases (and related library matches) so you can track new issues and auto-add series. The Releases page in the UI is organized around this week’s data, not a multi-week calendar.
Pull List Modes
The ALT_PULL setting historically selected how Comicarr retrieved the weekly pull list. Current Comicarr forces ALT_PULL to 2 (alternate retrieval) at config load — leave it at the default unless you are debugging older configs.
The pull list refreshes on a scheduler interval (often every few hours when alt-pull is active). You can force a refresh from Settings / background jobs when available.
Publisher Filtering
The pull list is organized by publisher groups. Each group has a visibility weight that controls display priority:
| Publisher | Config Key | Default Weight |
|---|---|---|
| DC Comics | BIGGIE_PUB | 55 |
| Marvel | BIGGIE_PUB | 55 |
| Dark Horse | INDIE_PUB | 75 |
| Image | INDIE_PUB | 75 |
| Indies (all others) | INDIE_PUB | 75 |
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.
| Setting | Default | Description |
|---|---|---|
WEEKFOLDER | False | Enable weekly folder organization. |
WEEKFOLDER_LOC | None | Directory where weekly folders are created. |
WEEKFOLDER_FORMAT | 0 | Folder 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:
| Code | Type | Description |
|---|---|---|
| HC | Hardcover | Collected hardcover editions |
| TP | Trade Paperback | Collected trade paperback editions |
| GN | Graphic Novel | Original graphic novels |
| SC | Softcover | Softcover collected editions |
| ONE SHOT | One Shot | Single 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.
AI-Powered Suggestions
When AI is configured, the weekly page at /weekly displays personalized suggestions alongside the standard pull list. Comicarr analyzes your collection patterns against the current week's releases and recommends titles you might want.
Suggestions are cached per pull list update, so they don't consume AI tokens on every page load. Each suggestion includes the title, publisher, and a reason based on your library.
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.