Filter, Rewrite and Scraper Rules

Filtering Rules

Miniflux has a basic filtering system that allows you to ignore or keep articles.

Block Rules

Block rules ignore articles with a title that match the regex.

For example, the regex (?i)miniflux will ignore all articles with a title that contains the word Miniflux (case insensitive).

Ignored articles won’t be saved into the database.

Keep Rules

Keep rules keeps only articles that matches the regex.

For example, the regex (?i)miniflux will keep only the articles with a title that contains the word Miniflux (case insensitive).

Rewrite Rules

To improve the reading experience, it’s possible to alter the content of feed items.

For example, if you are reading a popular comic website like XKCD, it’s nice to have the image title (the alt attribute) added under the image. Especially on mobile devices where there is no hover event.

Tries to add the highest quality images from sites that use JavaScript to load images (e.g. either lazily when scrolling or based on screen size).
Add each image's title as a caption under the image.
Insert Youtube video to the article (automatic for
Insert Invidious player to the article (automatic for
Insert Invidious player to the article for Youtube feeds.
Insert mailto links subject into the article.
Convert new lines \n to <br> (useful for non-HTML contents).
Convert text link to HTML links (useful for non-HTML contents).
Attempt to fix Medium's images rendered in Javascript.
Use <noscript> content for images rendered with Javascript.
replace("search term"|"replace term")
Search and replace text.

Miniflux includes a set of default rules for some websites, but you could define your own rules.

On the feed edit page, enter your custom rules in the field “Rewrite Rules” like this:


Separate each rule by a comma.

Scraper Rules

When an article contains only an extract of the content, you could fetch the original web page and apply a set of rules to get relevant contents.

Miniflux uses CSS selectors for custom rules. These custom rules can be saved in the feed properties (Select a feed and click on edit).

CSS Selector Description
div#articleBody Fetch a div element with the ID articleBody
div.content Fetch all div elements with the class content
article, div.article Use a comma to define multiple rules

Miniflux includes a list of predefined rules for popular websites. You could contribute to the project to keep them up to date.

Under the hood, Miniflux uses the library Goquery.