What Features Does Tiny Tiny RSS Offer?

Tiny Tiny RSS (tt-rss) is a free, open-source, web-based RSS/Atom feed reader and aggregator that you host yourself. Its feature set is aimed at people who want full control over their feed data and privacy rather than relying on a third-party service, and who are comfortable running a Docker-based web application. If you want a managed reader with zero setup, tt-rss is not that; if you want a self-hosted reader with folders, filtering, plugins, and an API, its features line up well.

Core reading and organization features

  • Folder and subfolder organization — Feeds can be grouped into folders and subfolders, so you can separate topics, projects, or sources.
  • Feed aggregation / syndication — It aggregates feeds and can also syndicate content back out.
  • Keyboard shortcuts — Built-in shortcuts for navigating and acting on articles without the mouse.
  • OPML import/export — Move your subscription list in and out of tt-rss, which matters if you are migrating from another reader.
  • Flexible article filtering — Rules to decide which articles surface, so high-volume feeds don't drown the ones you care about.

Sharing, content, and media handling

  • Multiple sharing methods — Export RSS feeds, use plugins for various social sites, or share by URL.
  • Sharing arbitrary content through tt-rss — Not limited to items that arrived via a feed.
  • Full article embedding via readability and site-specific plugins — Pulls in the complete article text when a feed only publishes an excerpt.
  • Deduplication, including perceptual hashing for images — Reduces repeated items, and the image hashing catches visually identical images even when the file differs.
  • Podcasts — Handles podcast feeds alongside regular articles.

Extensibility and customization

  • Plugins and themes — Extend behavior and change the interface appearance.
  • JSON API — Programmatic access for clients, scripts, or integrations.
  • Free software under GNU GPLv3 — You can inspect, modify, and redistribute it under that license.

What you need to run it

The project lists these requirements:

  1. A modern web browser — generally a recent version of Chrome/Chromium or Firefox.
  2. A system running Docker.

The Installation Guide covers the detailed steps. Running tt-rss without Docker is possible, but the project notes that support may be limited in that case.

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 general discussion: https://github.com/tt-rss/tt-rss/discussions
  • Bug reports and feature requests: https://github.com/tt-rss/tt-rss/issues
  • Contributing (code, translations, issue reports): see https://github.com/tt-rss/tt-rss/blob/main/CONTRIBUTING.md

The documentation is licensed under CC BY-SA 4.0; the tt-rss software is licensed under GNU GPLv3.

Choosing tt-rss or not

Pick tt-rss if self-hosting, data control, folder-based organization, filtering, plugins, and an API are your priorities, and you can run Docker. Look elsewhere if you want a hosted service with no server to maintain — the self-hosted model is the defining constraint here, not an optional extra.

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