Skip to content

RSS Feeds

Jump to bottom
Michael edited this page Jul 17, 2026 · 1 revision

RSS Feeds

The RSS poller ingests torrents from RSS and Torznab feeds on a schedule, feeding them into the same importer as Prowlarr and the DHT crawler. Each feed becomes its own source, filterable in the UI.

Enable the worker with --keys=rssfeed_poller (see Worker Keys) and configure feeds in config.yml.

Configuration

rss:
  feeds:
    - name: torrentdownloads
      url: https://www.torrentdownloads.pro/rss.xml
      enabled: true
      interval: 30m
    - name: some-other-feed
      url: https://example.com/rss
      enabled: true
      interval: 15m
Field Description
name Unique feed name; becomes the source key rss-<name>
url Feed URL (RSS 2.0 or Torznab)
enabled Whether to poll this feed
interval Poll interval (e.g. 15m, 1h); defaults to 15m if omitted

Each feed is polled on its own timer. A high-water mark per feed (stored in the rss_feed_state table) means a restart does not re-import the whole feed.

What feeds work

There is no single "torrent RSS" format, so the parser is deliberately permissive. A feed is usable if it exposes an info hash in any of these forms:

  • A magnet link in the item's link, enclosure, or guid (hex or base32)
  • A Torznab or Newznab <attr name="infohash"> element
  • A plain <info_hash> / <infohash> element (as TorrentDownloads uses)
  • An ezRSS <torrent><infoHash> / <magnetURI> block (as EZTV uses)
  • A bare info hash in the guid

The parser also reads seeders, leechers, and size from whichever tags the feed provides, and decodes non-UTF-8 feeds (e.g. ISO-8859-1). Feeds whose only link is an HTML page or a .torrent file with no hash cannot be imported -- there is nothing to extract.

Tip: avoid pointing an RSS feed at a source you already crawl through Prowlarr (e.g. EZTV). It works, but it duplicates the same content under a second source.

API

Method Route Purpose
GET /api/rss/feeds List configured feeds and their status
POST /api/rss/poll Trigger an on-demand poll ({"feedNames": ["name"]})

The RSS Feeds page in the web UI lists each configured feed with its enabled state, interval, torrent count, and last-poll time, plus a Poll Now button.

Clone this wiki locally