FreshRSS releases

Filter or

Statistics

Information

Icon

Change…

Title

Description

Website URL

Feed URL

Check the validity of the feed

Category

Visibility

Article unicity criteria

forced

Relevant for invalid feeds.
⚠️ Changing the policy will create duplicates.

Do not automatically refresh more often than

mute

HTTP username

Allows access to HTTP protected RSS feeds

HTTP password

Filter actions

Mark updated articles as unread

Mark an article as read…

if an identical title already exists in the top n newest articles of the feed

Mark an article as read…

upon receiving the article

Mark an article as read…

when it is no longer in the upstream news feed

Mark an article as read…

Write one search filter per line. Operators see documentation.

Max number of articles to keep unread

Archiving

10 articles

Update feeds

If no purge policy is selected, every article will be kept.

Purge policy

By default

Type of feed source

XPath 1.0 is a standard query language for advanced users, and which FreshRSS supports to enable Web scraping.

XPath for:
finding news items
(most important)

Example: //div[@class="news-item"]

XPath (relative to item) for:
item title

Use in particular the XPath axis descendant:: like descendant::h2

XPath (relative to item) for:
item content

Example to take the full item: .

XPath (relative to item) for:
item link (URL)

Example: descendant::a/@href

XPath (relative to item) for:
item thumbnail

Example: descendant::img/@src

XPath (relative to item) for:
item author

Can also be a static string. Example: "Anonymous"

XPath (relative to item) for:
item date

The result will be parsed by strtotime()

Custom date/time format

Optional. A format supported by DateTime::createFromFormat() such as d-m-Y H:i:s

XPath (relative to item) for:
item tags

XPath (relative to item) for:
item unique ID

XPath for JSON in HTML

Example: normalize-space(//script[@type="application/json"]) (single JSON)
or: //script[@type="application/ld+json"] (one JSON object per article)

A JSON dot notated uses dots between objects and brackets for arrays (e.g. data.items[0].title)

dot notation for:
finding news items
(most important)

JSON path to the array containing the items, e.g. $ or newsItems

dot notated path (relative to item) for:
item title

dot notated path (relative to item) for:
item content

Key under which the content is found, e.g. content

dot notated path (relative to item) for:
item link (URL)

Example: permalink

dot notated path (relative to item) for:
item thumbnail

Example: image

dot notated path (relative to item) for:
item author

dot notated path (relative to item) for:
item date

The result will be parsed by strtotime()

Custom date/time format

Optional. A format supported by DateTime::createFromFormat() such as d-m-Y H:i:s

dot notated path (relative to item) for:
item tags

dot notated path (relative to item) for:
item unique ID

Content retrieval

Article CSS selector on original website

Retrieves truncated RSS feeds (caution, requires more time!)

Conditions for content retrieval

Write one search filter per line. Operators see documentation.

Advanced

CSS selector of the elements to remove

A CSS selector may be a list such as: footer, aside, p[data-sanitized-class~="menu"]

Use Cookies when fetching the article content

Example: foo=bar; gdpr_consent=true; cookie=value

Accept cookies

Allow the feed server to set cookies (stored in memory for the duration of the request only)

Max HTTP redirects

Set to 0 or leave blank to disable, -1 for unlimited redirects

Content action when fetching the article content

Set the user agent for fetching this feed

Example: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:86.0)

Set a proxy for fetching this feed

Select a protocol (e.g: SOCKS5) and enter the proxy address (e.g: 127.0.0.1:1080 or username:password@127.0.0.1:1080)

HTTP Method

The POST payload has automatic support for application/x-www-form-urlencoded and application/json

Timeout in seconds

Verify SSL security

HTTP Headers

Headers are separated by a newline, and the name and value of a header are separated by a colon (e.g: Accept: application/atom+xml Authorization: Bearer some-token).

FreshRSS releases

Maintenance

Export