Tiny Tiny RSS is a free and open source web-based news feed (RSS/Atom) reader and aggregator.

## Screenshots

<img src="images/tt-rss/25.05/Screenshot_2025-05-10_at_09.22.19.webp" width="350" style="float: left">
<img src="images/tt-rss/25.05/Screenshot_2025-05-10_at_09.21.21.webp" width="350" style="float: left">
<img src="images/tt-rss/25.05/Screenshot_2025-05-10_at_09.22.50.webp" width="350">

## Features

- Free software, licensed under [GNU GPLv3](http://www.gnu.org/copyleft/gpl.html)
- Self-hosted: control your own data and protect your privacy instead of relying on third party services
- Supports:
  - organizing feeds by folders (and subfolders)
  - [feed aggregation / syndication](Generated-Feeds)
  - keyboard shortcuts
  - OPML import/export
  - multiple ways to share stuff: export RSS feeds, plugins for various social sites, sharing by URL, etc.
  - [sharing arbitrary content through tt-rss](Share-Anything)
  - [Plugins](Plugins) and [themes](Themes)
  - embedding full article content via readability and site-specific plugins
  - deduplication, including [perceptual hashing](https://github.com/supahgreg/tt-rss-plugin-perceptual-image-hash) for images
  - podcasts
  - [flexible article filtering](Content-Filters)
  - [JSON API](Api-Reference)
  - and much more…
- ~~[[Android Client]]~~

## Development

See https://github.com/supahgreg/tt-rss .

## Get in touch

* Go to https://github.com/supahgreg/tt-rss/discussions if you have questions or want to discuss something.
* Go to https://github.com/supahgreg/tt-rss/issues if you want to report an issue, request an enhancement/feature, etc.

## Contribute

Contributions (code, translations, reporting issues, etc.) are welcome.

* (not quite ready for this post-`tt-rss.org`) ~~Help translate tt-rss into your own language using [Weblate](https://hosted.weblate.org/engage/tt-rss/)~~
* [Code contribution guidelines](https://github.com/supahgreg/tt-rss/blob/main/CONTRIBUTING.md)

## Installation

You will need the following:

* A modern web browser. This generally means a recent version of Chrome/Chromium or Firefox;
* A server (VDS or physical) running Docker;

### [Docker installation guide](Installation-Notes)

Tiny Tiny RSS uses a continuous development model based on the `main` branch, which is considered stable. If possible, you should always be running the latest `main` branch code.

There’s no warranty. If it breaks you get to keep both parts.