FreshRSS è un aggregatore di feed RSS autoportato. È leggero, facile da usare, potente e personalizzabile. È un'applicazione multiutente con una modalità di lettura anonima. Supporta tag personalizzati. Esiste un'API per i client (mobili) e un'interfaccia a riga di comando. Richiedi un account: https://mastodon.uno/@devol/111879986134652899
Go to file
maTh bf68205ae3
Improved: Reading view: author (#6289)
* move the margin from themes to frss.css + delete font-size

* same source code as normal view for author information
2024-04-15 23:14:34 +02:00
.devcontainer Fix dev container Apache logs (#5660) 2023-09-18 08:41:25 +02:00
.github Bump actions/configure-pages from 4 to 5 (#6254) 2024-04-01 23:03:53 +02:00
Docker Fix CLI install regressions (#6214) 2024-03-19 13:42:12 +01:00
app Improved: Reading view: author (#6289) 2024-04-15 23:14:34 +02:00
cli PHP 8.3 #[\Override] (#6273) 2024-04-10 15:33:43 +02:00
data Improved: show Terms of Service in config menu (#5215) 2023-03-21 18:47:07 +01:00
docs Add some error prevention to Debian/Ubuntu installation docs (#6290) 2024-04-12 23:19:23 +02:00
extensions New core-extensions to allow Docker volumes for third-party extensions (#2837) 2020-03-22 16:31:20 +01:00
lib SimplePie replace iframe allow attribute (#6274) 2024-04-11 08:48:50 +02:00
p Improved: Reading view: author (#6289) 2024-04-15 23:14:34 +02:00
tests PHP 8.3 #[\Override] (#6273) 2024-04-10 15:33:43 +02:00
.dockerignore Minor .dockerignore (#5996) 2023-12-29 13:36:30 +01:00
.editorconfig Minor development config fixes (#5379) 2023-05-09 13:08:57 +02:00
.eslintignore Fix types for extensions (#5901) 2023-11-24 14:50:03 +01:00
.eslintrc.json New sharing service: Web sharing API (#4271) 2022-03-16 23:23:15 +01:00
.gitattributes export-ignore (#4415) 2022-06-19 20:03:17 +02:00
.gitignore Fix types for extensions (#5901) 2023-11-24 14:50:03 +01:00
.hadolint.yaml Readme 2454-2456 2019-07-23 10:01:52 +02:00
.jshintignore Fix types for extensions (#5901) 2023-11-24 14:50:03 +01:00
.jshintrc ESLint upgrade from JSHint (#3906) 2021-10-21 11:44:03 +02:00
.markdownlint.json Fix Docker button, add PikaPods as automated install option (#4351) 2022-05-07 14:28:28 +02:00
.markdownlintignore Fix types for extensions (#5901) 2023-11-24 14:50:03 +01:00
.stylelintignore Exclude .git folder (#4824) 2022-11-06 19:05:09 -05:00
.stylelintrc.json Update @stylistic/stylelint-plugin (#6307) 2024-04-15 15:50:00 +02:00
.typos.toml Updated Hungarian translation (#5918) 2023-12-03 14:08:48 +01:00
CHANGELOG-old.md Update all test dependencies (#4419) 2022-06-19 20:08:42 +02:00
CHANGELOG.md Prepare next dev version 2023-12-30 17:29:27 +01:00
CONTRIBUTING.md fix: Broken link in CONTRIBUTING.md (#4896) 2022-11-25 21:59:26 +01:00
CREDITS.md Update CREDITS.md (#6069) 2024-01-26 12:25:33 +01:00
LICENSE.txt Update chmod for LICENSE.txt 2018-12-22 11:39:08 +01:00
Makefile Makefile: add `-it` to `make start` to allow for Ctrl+C SIGTERM (#6239) 2024-03-26 21:53:06 +01:00
README.fr.md Add some error prevention to Debian/Ubuntu installation docs (#6290) 2024-04-12 23:19:23 +02:00
README.md New feature: shareable user query (#6052) 2024-02-26 09:01:03 +01:00
SECURITY.md Update SECURITY.md (#5448) 2023-06-09 08:26:53 +02:00
composer.json PHP 8.3 #[\Override] (#6273) 2024-04-10 15:33:43 +02:00
composer.lock PHP 8.3 #[\Override] (#6273) 2024-04-10 15:33:43 +02:00
config-user.default.php delete rss view shortcut (#6131) 2024-02-27 23:57:23 +01:00
config.default.php System option for number of feeds to refresh in parallel (#6124) 2024-02-26 09:01:49 +01:00
constants.php Prepare next dev version 2023-12-30 17:29:27 +01:00
force-https.default.txt Always rewrite blogger.com to https (#3088) 2020-07-04 11:17:22 +02:00
index.html Config allow robots 2015-10-25 00:01:13 +02:00
index.php Use strict_types (#5830) 2023-11-16 22:43:00 +01:00
opml.default.xml Default or custom OPML (#2627) 2019-11-04 17:45:15 +01:00
package-lock.json Update @stylistic/stylelint-plugin (#6307) 2024-04-15 15:50:00 +02:00
package.json Update @stylistic/stylelint-plugin (#6307) 2024-04-15 15:50:00 +02:00
phpcs.xml Fix types for extensions (#5901) 2023-11-24 14:50:03 +01:00
phpstan-next.neon PHP 8.3 #[\Override] (#6273) 2024-04-10 15:33:43 +02:00
phpstan.neon PHP 8.3 #[\Override] (#6273) 2024-04-10 15:33:43 +02:00

README.md

Liberapay donations

FreshRSS

FreshRSS is a self-hosted RSS feed aggregator.

It is lightweight, easy to work with, powerful, and customizable.

It is a multi-user application with an anonymous reading mode. It supports custom tags. There is an API for (mobile) clients, and a Command-Line Interface.

Thanks to the WebSub standard, FreshRSS is able to receive instant push notifications from compatible sources, such as Friendica, WordPress, Blogger, Medium, etc.

FreshRSS natively supports basic Web scraping, based on XPath, for Web sites not providing any RSS / Atom feed. Also supports JSON documents.

FreshRSS offers the ability to reshare selections of articles by HTML, RSS, and OPML.

Different login methods are supported: Web form (including an anonymous option), HTTP Authentication (compatible with proxy delegation), OpenID Connect.

Finally, FreshRSS supports extensions for further tuning.

FreshRSS logo

Feedback and contributions

Feature requests, bug reports, and other contributions are welcome. The best way is to open an issue on GitHub. We are a friendly community.

To facilitate contributions, the following option is available:

Open in GitHub Codespaces

Screenshot

FreshRSS screenshot

Disclaimer

FreshRSS comes with absolutely no warranty.

Documentation

Requirements

  • A recent browser like Firefox / IceCat, Edge, Chromium / Chrome, Opera, Safari.
    • Works on mobile (except a few features)
  • Light server running Linux or Windows
    • It even works on Raspberry Pi 1 with response time under a second (tested with 150 feeds, 22k articles)
  • A web server: Apache2.4+ (recommended), nginx, lighttpd (not tested on others)
  • PHP 7.4+
  • PostgreSQL 9.5+ or SQLite or MySQL 5.5.3+ or MariaDB 5.5+

Installation

The latest stable release can be found here. New versions are released every two to three months.

If you want a rolling release with the newest features, or want to help testing or developing the next stable version, you can use the edge branch.

Automated install

  • Docker
  • YunoHost
  • Cloudron
  • PikaPods

Manual install

  1. Get FreshRSS with git or by downloading the archive
  2. Put the application somewhere on your server (expose only the ./p/ folder to the Web)
  3. Add write access to the ./data/ folder for the webserver user
  4. Access FreshRSS with your browser and follow the installation process
  5. Everything should be working :) If you encounter any problems, feel free to contact us.
  6. Advanced configuration settings can be found in config.default.php and modified in data/config.php.
  7. When using Apache, enable AllowEncodedSlashes for better compatibility with mobile clients.

More detailed information about installation and server configuration can be found in our documentation.

Advice

  • For better security, expose only the ./p/ folder to the Web.
    • Be aware that the ./data/ folder contains all personal data, so it is a bad idea to expose it.
  • The ./constants.php file defines access to the application folder. If you want to customize your installation, look here first.
  • If you encounter any problem, logs are accessible from the interface or manually in ./data/users/*/log*.txt files.
    • The special folder ./data/users/_/ contains the part of the logs that are shared by all users.

FAQ

  • The date and time in the right-hand column is the date declared by the feed, not the time at which the article was received by FreshRSS, and it is not used for sorting.
    • In particular, when importing a new feed, all of its articles will appear at the top of the feed list regardless of their declared date.

Extensions

FreshRSS supports further customizations by adding extensions on top of its core functionality. See the repository dedicated to those extensions.

APIs & native apps

FreshRSS supports access from mobile / native apps for Linux, Android, iOS, Windows and macOS, via two distinct APIs: Google Reader API (best), and Fever API (limited features and less efficient).

App Platform Free Software Maintained & Developed API Works offline Fast sync Fetch more in individual views Fetch read articles Favourites Labels Podcasts Manage feeds
News+ with Google Reader extension Android Partially 2015 GReader ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
FeedMe* Android ✔️✔️ GReader ✔️ ✔️ ✔️ ✔️
EasyRSS Android ✔️ ✔️ GReader Bug ✔️
Readrops Android ✔️ ✔️✔️ GReader ✔️ ✔️
Fluent Reader Lite Android, iOS ✔️ ✔️✔️ GReader, Fever ✔️
FocusReader Android ✔️✔️ GReader ✔️ ✔️ ✔️
Read You Android ✔️ Work in progress GReader, Fever ✔️ ✔️ ✔️
ChristopheHenry Android ✔️ Work in progress GReader ✔️ ✔️ ✔️
Fluent Reader Windows, Linux, macOS ✔️ ✔️✔️ GReader, Fever ✔️ ✔️
RSS Guard Windows, GNU/Linux, macOS, OS/2 ✔️ ✔️✔️ GReader ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
NewsFlash GNU/Linux ✔️ ✔️✔️ GReader, Fever ✔️ ✔️ ✔️
Newsboat 2.24+ GNU/Linux, macOS, FreeBSD ✔️ ✔️✔️ GReader ✔️ ✔️ ✔️
Vienna RSS macOS ✔️ ✔️✔️ GReader
Readkit iOS, macOS ✔️✔️ GReader ✔️ ✔️ ✔️ 💲
Reeder* iOS, macOS ✔️✔️ GReader, Fever ✔️ ✔️ ✔️ ✔️
lire iOS, macOS ✔️✔️ GReader
Unread iOS ✔️✔️ Fever ✔️ ✔️
Fiery Feeds iOS ✔️✔️ Fever
Netnewswire iOS, macOS ✔️ Work in progress GReader ✔️ ✔️ ✔️

* Install and enable the GReader Redate extension to have the correct publication date for feed articles if you are using Reeder 4 or FeedMe. (No longer required for Reeder 5)

Included libraries

Only for some options or configurations

Alternatives

If FreshRSS does not suit you for one reason or another, here are alternative solutions to consider: