summaryrefslogtreecommitdiff
path: root/Home.md
blob: 729be8f9e5cbf314a468f1deba10bca795ba890c (plain)
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
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/tt-rss/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 [[Installation Guide]] for detailed instructions.

> [!WARNING]
> If you choose to run tt-rss without using Docker support might be limited.

> [!NOTE]
> 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/tt-rss/tt-rss/discussions if you have questions or want to discuss something.
* Go to https://github.com/tt-rss/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/tt-rss/tt-rss .
* Help translate tt-rss into your own language using [Weblate](https://hosted.weblate.org/engage/tt-rss/).