1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
Tiny Tiny RSS (tt-rss) is a free, flexible, open source, web-based news feed (RSS/Atom/other) 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">](images/tt-rss/25.05/Screenshot_2025-05-10_at_09.22.19.webp)
[<img src="images/tt-rss/25.05/Screenshot_2025-05-10_at_09.21.21.webp" width="350" style="float: left">](images/tt-rss/25.05/Screenshot_2025-05-10_at_09.21.21.webp)
[<img src="images/tt-rss/25.05/Screenshot_2025-05-10_at_09.22.50.webp" width="350">](images/tt-rss/25.05/Screenshot_2025-05-10_at_09.22.50.webp)
## 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]]~~
## Installation
You will need the following:
* A modern web browser. This generally means a recent version of Chrome/Chromium or Firefox.
* A system running Docker.
See the [Docker installation guide](Installation-Notes) for detailed instructions.
> [!WARNING]
> If you choose to run tt-rss without using Docker support might be limited.
> [!INFO]
> Tiny Tiny RSS uses a continuous development model based on the `main` branch, which is considered stable.
> It's strongly recommended that you remain current-- meaning using either the most recent Docker image(s) or commit on `main`.
## 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.
## Development and Contributing
* Contributions (code, translations, reporting issues, etc.) are welcome.
* Development and issue tracking primarily happens in https://github.com/supahgreg/tt-rss .
* (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/)~~
|