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:
- A modern web browser — generally a recent version of Chrome/Chromium or Firefox.
- 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.