Weekly Pull List
Track new comic releases each week, auto-add series, and organize files into weekly folders.
The weekly pull list shows every comic released in a week and how each one relates to your library, so you can track new issues and add series. It lives under Releases → Industry.
Browsing weeks
Industry opens on the current week. Use the arrows to step back up to a year or ahead up to four weeks, and This week to return. The link in your address bar names the week, so you can bookmark or share it.
When you open a week Comicarr has not saved yet, it fetches that week from Walksoftly. If Walksoftly fails, it fetches from ComicVine instead, which needs a ComicVine API key. Opening a week only saves its list and never changes the status of any issue. If neither source has the week yet, as often happens for weeks further ahead, the page says so. Comicarr tries that week again 15 minutes later.
Reading a week
Each release shows one of four states. The legend above the list counts each one.
| State | Meaning |
|---|---|
| Wanted | The series is in your library and this issue is Wanted, Snatched, or being retried. |
| Downloaded | You already have this issue. |
| In library | The series is in your library but this issue is not Wanted. |
| Not in library | You don't have this series. |
Filter by title or publisher, and sort by title, publisher, or issue number. A title opens the series in your library, or its ComicVine page when you don't have it.
Acting on a release
- Want appears on releases from series you already have. It marks the issue Wanted and starts a search.
- Add appears on releases from series you don't have. Choose Add series to add it on its own, or Add series and want #N to add it and mark that issue Wanted once the add finishes. The issue is then picked up by the next scheduled search.
A release without a ComicVine id cannot be added from the pull list. Search for the series instead.
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, so 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, Releases → Industry shows personalized suggestions above the current week's 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) limits day-zero pack processing to series already on your watchlist. Disable it to grab everything in the pack.