Skip to content
Weaver Docs

RSS And Watch Folder

Two intake paths run without Upload. RSS polls indexer feeds and submits items that match your rules. The watch folder imports files that land in a folder on disk. Both assign categories and both are configured under Settings.

RSS

Section titled “RSS”

Feeds

Section titled “Feeds”

Settings → RSS → Add Feed takes a name, the feed URL, an optional username and password for basic auth, a Poll Interval in seconds, a Default Category, and Default Metadata applied to every accepted item. The poll loop ticks once a minute and polls each feed whose interval has elapsed. An empty interval means 15 minutes. A disabled feed keeps its configuration and is skipped.

Feeds on your own LAN need WEAVER_RSS_ALLOW_PRIVATE_NETWORK=1, because feed fetches refuse private, loopback, and link-local addresses by default.

Rules

Section titled “Rules”

Each feed has an ordered list of rules. A feed with no accept rule submits nothing. A rule has:

  • Action: Accept or Reject.
  • Sort Order. Rules run in order and the first match decides.
  • Title Regex, matched against the item title.
  • Item Categories: comma-separated feed categories, any of which must match.
  • Min Size and Max Size in bytes. An item with no size fails a size condition.
  • Category Override and Rule Metadata for accepted items.

Put narrow reject rules before broad accept rules. A rule with an invalid regex is ignored and logged.

Running And Seen History

Section titled “Running And Seen History”

Run All Feeds or Run Feed polls immediately and shows a Sync Report: feeds polled, items fetched, new, accepted, submitted, and ignored. Each feed card keeps a Seen History of item decisions with the resulting job. Weaver remembers seen items for 180 days. Forget one item or Clear Seen to let the feed reconsider.

Watch Folder

Section titled “Watch Folder”

Settings → Watch Folder imports .nzb and .nzb.xz files, and supported archives containing them, from a folder Weaver can read and rename in.

  • Mode: Off, Polling every Poll Interval seconds (default 60), or Realtime watching using filesystem notifications.
  • Folder: browse to a directory on the server.
  • Category Subfolders: on by default. A file in an immediate subfolder named after an existing category, or one of its aliases, gets that category.

A file is picked up once it has stopped changing for a few seconds. After processing, the source is renamed with a marker suffix: .queued when submitted, .error when rejected permanently, .partial when an archive was only partly usable. Transient problems such as a missing server are retried on later scans and escalate after a day. Scan now runs a scan and shows the report: discovered, queued, skipped, marker renames, and errors.

Schedules can pause and resume scanning. See Bandwidth And Schedules.

Section titled “Related”