FireRSS is a browser extension that discovers RSS and Atom feed candidates through page metadata, configurable templates, and optional origin-level scanning.
- Collects RSS and Atom feed candidates exposed by the current page.
- Configurable page/feed URL templates can derive candidates directly with named placeholders and bypass Extended Feed Scan.
- Extended Feed Scan checks common feed paths at the website origin without sending cookies or a referrer.
- Extended Scan Exclusions disable active requests for matching URLs while preserving passive page and Feed Template detection.
- Imports and exports settings as a versioned JSON file.
- Optionally syncs settings through Google Sync on Chromium or Mozilla Sync on Firefox.
Browser-native sync stays within each browser ecosystem. Use settings export/import to transfer between Chromium and Firefox.
Feed templates always run, even when Extended Feed Scan is disabled. They use page URL template => feed URL template syntax, and named placeholders are copied from the page URL:
https://t.me/<user> => https://rss-bridge.org/bridge01/?action=display&bridge=TelegramBridge&username=<username>&format=Atom'
Extended Feed Scan only probes root paths such as /feed, /rss.xml, and /atom.xml. Positive results are cached per origin for 24 hours and negative results for 15 minutes to avoid repeated requests. Add sensitive sites to Extended Scan Exclusions instead of Ignored URLs when passive feed discovery should remain available.
After single-page navigation, FireRSS watches for updated feed metadata. If the page does not expose the new metadata in the live document, FireRSS requests the current page once without cookies or a referrer and parses only its RSS/Atom metadata.
FireRSS 3 is a breaking release. It changes the settings model, separates Extended Scan Exclusions from fully ignored URLs, and makes Exact Host matching truly hostname-specific.
Before migrating schema v1/v2 settings, FireRSS stores the original settings in local extension storage. On the first upgrade from FireRSS 2, the options page opens with a migration notice. The legacy backup can be downloaded from the notice or later from Import / Export, and the downloaded file can be restored with Import. Reset All Options removes this backup.
Chrome
-
Clone the repository
git clone https://github.com/mt190502/firerss.git cd firerss -
Install the Node.js and pnpm dependencies
pnpm install
-
Generate PEM key
mkdir -p ~/.ssh openssl genrsa 2048 | openssl pkcs8 -topk8 -nocrypt -out ~/.ssh/crx.pem
-
Build the extension
CHROMIUM_PATH=$(which chromium-browser) make chromium -
Open Chrome and go to
chrome://extensions/chrome://extensions/
-
Open the file explorer and drag and drop the
dist/chromium.crxfile to the extensions page. -
Click on
Add Extensionto install the extension.
Firefox
-
Clone the repository
git clone https://github.com/mt190502/firerss.git cd firerss -
Install the Node.js and pnpm dependencies
pnpm install
-
Build the extension
make firefox
-
Open Firefox and go to
about:debugging -
Then click
This Firefoxand clickLoad Temporary Add-on... -
Select
manifest.jsonfromdist/firefox/under the project folder.
See LICENSE