index.md


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
55
56
57
58
59
60
61
62
63
64
65
66

---
hide:
  - navigation
  - toc
---

<style>
  .md-typeset h1,
  .md-content__button {
    display: none;
  }
</style>

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

## Screenshots

![](images/tt-rss/25.05/Screenshot_2025-05-10_at_09.22.19.webp){ width="350", align=left }
![](images/tt-rss/25.05/Screenshot_2025-05-10_at_09.21.21.webp){ width="350", align=left }
![](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](wiki/GeneratedFeeds.md),
    -   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](wiki/ShareAnything.md),
    -   [Plugins](Plugins.md) and [themes](Themes.md),
    -   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](wiki/ContentFilters.md),
    -   [JSON API](ApiReference.md),
    -   and much more…
-   [Android client](AndroidClient.md);

## Development

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

## Get in touch

Join https://github.com/supahgreg/tt-rss/discussions if you have questions or need to report a bug.

## Contribute

<!-- * 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 recent Chrome or compatible;
* A server (VDS or physical) running Docker;

### [Docker installation guide](wiki/InstallationNotes.md)

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

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