What is Tiny Tiny RSS (tt-rss.org)?

Tiny Tiny RSS (tt-rss) is a free, open-source, web-based RSS/Atom feed reader and aggregator, and tt-rss.org is its official project site. It is for people who want to read and organize feeds on a server they control rather than through a third-party hosted service. The site itself is a landing page: it introduces the software, lists features, shows screenshots, links to installation instructions, and points to community and development channels.

What the software does

At its core, tt-rss collects feeds and presents them in a web interface. The project describes it as a "free, flexible, open-source, web-based news feed (RSS/Atom/other) reader and aggregator."

Key capabilities listed on the site include:

  • Self-hosting — you run it yourself, so you "control your own data and protect your privacy instead of relying on third party services."
  • Feed organization — organize feeds by folders and subfolders.
  • Aggregation and syndication — combine and redistribute feeds.
  • Keyboard shortcuts — navigate and act without a mouse.
  • OPML import/export — move feed subscriptions in and out.
  • Multiple sharing methods — export RSS feeds, use plugins for various social sites, or share by URL.
  • Sharing arbitrary content — push non-feed content through tt-rss.
  • Plugins and themes — extend and restyle the interface.
  • Full article embedding — pull in complete article content via readability and site-specific plugins.
  • Deduplication — including perceptual hashing for images.
  • Podcasts — handle audio feeds.
  • Flexible article filtering — rules to decide what you see.
  • JSON API — programmatic access for clients and integrations.

The site notes there is "much more," so the list above is not exhaustive.

Licensing and cost

tt-rss is free software licensed under GNU GPLv3. The site describes it as "free, flexible, open-source." The available page material does not list prices or paid tiers, so no pricing conclusion should be drawn beyond the open-source license.

How it is installed and run

According to the site, installation requires:

  1. A modern web browser — generally a recent version of Chrome/Chromium or Firefox.
  2. A system running Docker — the Installation Guide provides detailed instructions.

Two important operational notes from the project:

  • If you run tt-rss without Docker, "support might be limited."
  • tt-rss uses a continuous development model based on the main branch, which is considered stable. The project "strongly recommends" staying current — using either the most recent Docker image(s) or the latest commit on main.

Where to get help and contribute

  • Questions and discussion: https://github.com/tt-rss/tt-rss/discussions
  • Issues, enhancements, feature requests: https://github.com/tt-rss/tt-rss/issues
  • Contributing (code, translations, reporting issues): https://github.com/tt-rss/tt-rss/blob/main/CONTRIBUTING.md

Contributions are welcome. The documentation is licensed under CC BY-SA 4.0, while the software is under GNU GPLv3.

Who it is for

tt-rss fits you if you want a self-hosted feed reader, are comfortable running Docker, and prefer open-source software you can inspect and extend. It is less suited if you want a zero-setup hosted reader or cannot run a server or Docker environment, since the project ties its recommended path to Docker and continuous updates.

tt-rss.org
Tiny Tiny RSS (tt-rss) is a free, flexible, open-source, web-based news feed (RSS/Atom/other) reader and aggregator.