# FreshRSS/FreshRSS

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/freshrss-freshrss).**

14,059 stars · 1,102 forks · PHP · agpl-3.0

## Links

- GitHub: https://github.com/FreshRSS/FreshRSS
- Homepage: https://freshrss.org
- awesome-repositories: https://awesome-repositories.com/repository/freshrss-freshrss.md

## Topics

`feed` `freshrss` `news-aggregator` `php` `rss` `rss-aggregator` `rss-reader` `self-hosted` `websub`

## Description

FreshRSS is an open-source, self-hosted web feed aggregator designed to collect, organize, and display content from multiple websites in a single, centralized interface. It functions as a comprehensive reader for standard syndication formats, allowing users to track updates from various sources while maintaining full control over their data and privacy. The platform supports multi-user environments, enabling individual account management and personalized reading experiences.

The application distinguishes itself through its robust synchronization and extensibility capabilities. It provides a standardized interface for external mobile and desktop clients to sync reading progress and subscription lists, ensuring a consistent experience across devices. Users can extend the core functionality through a hook-based system that allows for custom logic, UI modifications, and theme integration without altering the primary codebase. Additionally, the platform includes advanced content processing tools, such as web scraping and full-text extraction, to generate structured feeds from websites that lack native syndication.

Beyond core aggregation, the system offers extensive tools for information management, including advanced search queries, automated filtering rules, and category-based organization. It handles background tasks for content retrieval and database maintenance, ensuring that feeds remain current and storage usage is optimized through configurable retention policies. The platform is built on a modular architecture that supports diverse deployment scenarios, including cloud hosting and reverse proxy configurations.

The software is distributed as a self-hosted PHP application, providing comprehensive documentation for installation, server configuration, and administrative maintenance via both a graphical interface and command-line utilities.

## Tags

### Content Management & Publishing

- [RSS Readers](https://awesome-repositories.com/f/content-management-publishing/content-aggregation-curation/rss-readers.md) — Aggregates and displays content from multiple websites in a single, centralized interface for streamlined reading.
- [Content Aggregators](https://awesome-repositories.com/f/content-management-publishing/content-aggregation-curation/content-aggregators.md) — Consolidates content from multiple web sources into a single, centralized reading interface. ([source](https://freshrss.github.io/FreshRSS/en/users/02_First_steps.html))
- [Category Organizations](https://awesome-repositories.com/f/content-management-publishing/category-organizations.md) — Groups content into user-defined categories to allow quick navigation and viewing of specific feed collections. ([source](https://freshrss.github.io/FreshRSS/en/users/10_filter.html))
- [Syndication Feed Generators](https://awesome-repositories.com/f/content-management-publishing/content-aggregation-curation/syndication-feed-generators.md) — Generates structured feeds from websites that lack native syndication. ([source](https://freshrss.github.io/FreshRSS/en/users/11_website_scraping.html))
- [Source Filters](https://awesome-repositories.com/f/content-management-publishing/content-aggregation-curation/feed-filtering-heuristics/source-filters.md) — Isolates content from specific sources using sidebar selection to focus on individual publishers. ([source](https://freshrss.github.io/FreshRSS/en/users/10_filter.html))
- [Content Extraction Engines](https://awesome-repositories.com/f/content-management-publishing/content-processing-transformation/content-extraction-engines.md) — Parses non-standard websites to generate structured feeds for tracking updates from sources lacking native syndication.

### Data & Databases

- [External Feed Integrations](https://awesome-repositories.com/f/data-databases/external-data-integrations/external-feed-integrations.md) — Provides a standardized API for external mobile and desktop clients to synchronize feed subscriptions and reading progress. ([source](https://freshrss.github.io/FreshRSS/en/developers/06_GoogleReader_API.html))
- [Subscription Feed Retrievers](https://awesome-repositories.com/f/data-databases/data-feeds/subscription-feed-retrievers.md) — Aggregates content by subscribing to feed URLs or importing subscription lists. ([source](https://freshrss.github.io/FreshRSS/en/users/02_First_steps.html))
- [Database-Backed Configurations](https://awesome-repositories.com/f/data-databases/database-backed-configurations.md) — Stores user subscriptions, article content, and configuration settings in a relational database.
- [Query Languages](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-and-indexing/query-languages.md) — Refines article discovery using a query language that supports filtering by metadata, dates, tags, and content patterns. ([source](https://freshrss.github.io/FreshRSS/en/users/10_filter.html))
- [Content Extraction](https://awesome-repositories.com/f/data-databases/content-extraction.md) — Retrieves full article text from external links to improve readability. ([source](https://freshrss.github.io/FreshRSS/en/developers/OPML.html))
- [Content Query Filters](https://awesome-repositories.com/f/data-databases/data-access-querying/api-query-languages/content-api-query-filters/content-query-filters.md) — Enables organizing and searching through aggregated content using custom queries, categories, and automated filtering rules.
- [Database Backup Management](https://awesome-repositories.com/f/data-databases/data-engineering-infrastructure/backup-and-recovery-utilities/database-backup-management.md) — Schedules periodic data exports and manages backup retention policies. ([source](https://freshrss.github.io/FreshRSS/en/admins/05_Backup.html))
- [Full Text Search](https://awesome-repositories.com/f/data-databases/full-text-search.md) — Accelerates search results by creating database indexes on article titles, content, and metadata. ([source](https://freshrss.github.io/FreshRSS/en/admins/DatabaseConfig.html))
- [Chronological Retrieval](https://awesome-repositories.com/f/data-databases/chronological-retrieval.md) — Adjusts the chronological order of displayed articles to prioritize the newest or oldest content. ([source](https://freshrss.github.io/FreshRSS/en/users/10_filter.html))
- [Scheduling Update Controls](https://awesome-repositories.com/f/data-databases/data-synchronization-configurations/scheduling-update-controls.md) — Enables granular control over feed refresh intervals to balance content freshness and server load. ([source](https://freshrss.github.io/FreshRSS/en/users/09_refreshing_feeds.html))
- [Saved Search Queries](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-and-indexing/saved-search-queries.md) — Stores complex search and filter criteria as reusable shortcuts. ([source](https://freshrss.github.io/FreshRSS/en/users/user_queries.html))
- [Cache Timeout Management](https://awesome-repositories.com/f/data-databases/data-engineering-infrastructure/caching-performance/caching-strategies/cache-timeout-management.md) — Configures expiration policies for cached content to balance storage usage and data access speed. ([source](https://freshrss.github.io/FreshRSS/en/admins/17_configs_not_ui.html))
- [Feed Retention Policies](https://awesome-repositories.com/f/data-databases/data-feeds/subscription-feed-retrievers/feed-retention-policies.md) — Allows users to customize article storage duration and feed update frequency. ([source](https://freshrss.github.io/FreshRSS/en/users/04_Subscriptions.html))
- [Data Import and Export](https://awesome-repositories.com/f/data-databases/data-import-and-export.md) — Migrates feed lists and settings using standard formats for backups and transfers. ([source](https://freshrss.github.io/FreshRSS/en/users/04_Subscriptions.html))
- [Database Schema Migrations](https://awesome-repositories.com/f/data-databases/database-management-systems/database-systems-management/database-management/database-schema-migrations.md) — Automates database schema updates during application upgrades to maintain structural compatibility.
- [Relational Database Persistence](https://awesome-repositories.com/f/data-databases/relational-database-persistence.md) — Persists user feeds, articles, and configuration settings in a relational database for consistent state management. ([source](https://freshrss.github.io/FreshRSS/en/developers/03_Backend/01_Database_schema.html))
- [Session State Management](https://awesome-repositories.com/f/data-databases/session-state-management.md) — Maintains user-specific state across requests using session variables. ([source](https://freshrss.github.io/FreshRSS/en/developers/Minz/))

### Business & Productivity Software

- [Automated Extraction Schedulers](https://awesome-repositories.com/f/business-productivity-software/scheduling-automation/automated-extraction-schedulers.md) — Schedules recurring background tasks to automatically fetch and update feed content. ([source](https://freshrss.github.io/FreshRSS/en/admins/01_Index.html))
- [Browser Notifications](https://awesome-repositories.com/f/business-productivity-software/browser-notifications.md) — Displays desktop notifications for new content with configurable alert durations. ([source](https://freshrss.github.io/FreshRSS/en/users/05_Configuration.html))
- [Self-Registration Portals](https://awesome-repositories.com/f/business-productivity-software/self-registration-portals.md) — Allows users to create their own accounts via a frontend form. ([source](https://freshrss.github.io/FreshRSS/en/admins/12_User_management.html))

### DevOps & Infrastructure

- [Self-Hosted Infrastructure](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-infrastructure.md) — Enables self-hosted content aggregation while maintaining full control over data and privacy.
- [Build System Extensions](https://awesome-repositories.com/f/devops-infrastructure/cicd-pipeline-automation/core-build-engines/bundling-extension-architectures/build-system-extensions.md) — Supports a modular architecture for adding features without modifying core code. ([source](https://freshrss.github.io/FreshRSS/en/))
- [Self-Hosted Deployment Tools](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-deployment-tools.md) — Automates the setup and deployment of self-hosted instances on private infrastructure. ([source](https://freshrss.github.io/FreshRSS/en/admins/14_CloudProviders.html))

### Networking & Communication

- [Cross-Platform Synchronization Services](https://awesome-repositories.com/f/networking-communication/cross-platform-synchronization-services.md) — Synchronizes reading progress and subscription lists across mobile and desktop clients using standardized APIs.

### Security & Cryptography

- [User Account Management](https://awesome-repositories.com/f/security-cryptography/user-account-management.md) — Provides comprehensive tools for managing user profiles, privileges, and security settings. ([source](https://freshrss.github.io/FreshRSS/en/users/05_Configuration.html))
- [OIDC Authentication Plugins](https://awesome-repositories.com/f/security-cryptography/oidc-authentication-plugins.md) — Delegates user authentication to external providers using OpenID Connect. ([source](https://freshrss.github.io/FreshRSS/en/admins/16_OpenID-Connect-Authentik.html))

### Web Development

- [Feed Synchronization APIs](https://awesome-repositories.com/f/web-development/web-platforms/feed-synchronization-apis.md) — Synchronizes reading progress and subscription lists across multiple devices using standardized APIs.
- [Status Toggles](https://awesome-repositories.com/f/web-development/content-statuses/status-toggles.md) — Filters the display based on read status or favorite designation to help manage and prioritize content. ([source](https://freshrss.github.io/FreshRSS/en/users/10_filter.html))

### Software Engineering & Architecture

- [Event Hooks](https://awesome-repositories.com/f/software-engineering-architecture/event-hooks.md) — Provides a hook-based system for executing custom logic during application lifecycle events. ([source](https://freshrss.github.io/FreshRSS/en/developers/03_Backend/05_Extensions.html))
- [Rendering Thresholds](https://awesome-repositories.com/f/software-engineering-architecture/performance-reliability/performance-optimization/data-handling-throughput/large-dataset-optimizations/rendering-thresholds.md) — Adjusts internal layout rendering thresholds to maintain interface responsiveness when processing thousands of subscriptions. ([source](https://freshrss.github.io/FreshRSS/en/admins/17_configs_not_ui.html))
- [Hook-Based Plugin Systems](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/plugin-module-systems/modular-plugin-architectures/plugin-based-architectures/hook-based-plugin-systems.md) — Provides a hook-based system for injecting custom logic and UI elements without modifying core code.
- [Controller-Based Routing](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/api-design-management/api-patterns/controller-based-routing.md) — Maps incoming web requests to specific controller methods for request handling. ([source](https://freshrss.github.io/FreshRSS/en/developers/Minz/))

### System Administration & Monitoring

- [Background Task Scheduling](https://awesome-repositories.com/f/system-administration-monitoring/background-task-scheduling.md) — Triggers recurring server-side processes to fetch remote content and perform maintenance tasks.
- [Instance Configuration Managers](https://awesome-repositories.com/f/system-administration-monitoring/instance-configuration-managers.md) — Supports instance-wide configuration for tailoring behavior and defaults. ([source](https://freshrss.github.io/FreshRSS/en/admins/03_Installation.html))
- [Multi-User Hosting Environments](https://awesome-repositories.com/f/system-administration-monitoring/multi-user-hosting-environments.md) — Provides ready-to-use hosting environments where multiple users access a centralized aggregator without managing their own infrastructure. ([source](https://freshrss.github.io/FreshRSS/en/admins/14_CloudProviders.html))
- [Software Update Managers](https://awesome-repositories.com/f/system-administration-monitoring/software-update-managers.md) — The application upgrades the software to the latest stable release using the interface or manual file replacement while preserving user data. ([source](https://freshrss.github.io/FreshRSS/en/admins/04_Updating.html))

### User Interface & Experience

- [Keyboard Navigation](https://awesome-repositories.com/f/user-interface-experience/keyboard-navigation.md) — Supports customizable keyboard shortcuts for efficient navigation and article browsing. ([source](https://freshrss.github.io/FreshRSS/en/users/05_Configuration.html))
- [Mobile Interfaces](https://awesome-repositories.com/f/user-interface-experience/mobile-interfaces.md) — Automatically resizes and reformats the interface for mobile screens. ([source](https://freshrss.github.io/FreshRSS/en/users/06_Mobile_access.html))
- [Theme Management](https://awesome-repositories.com/f/user-interface-experience/styling-theming-systems/content-styling/theme-management.md) — Supports theme installation and custom style injection for interface modification. ([source](https://freshrss.github.io/FreshRSS/en/users/05_Configuration.html))

### Education & Learning Resources

- [Automated Read Status Rules](https://awesome-repositories.com/f/education-learning-resources/technical-articles/automated-read-status-rules.md) — Automatically marks articles as read based on defined search terms to reduce reading noise. ([source](https://freshrss.github.io/FreshRSS/en/users/04_Subscriptions.html))