Tiny Tiny RSS (tt-rss)

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

Getting started

Please refer to the wiki.

Some notes about this project

• The original tt-rss project, hosted at https://tt-rss.org/ and its various subdomains, will be gone after 2025-11-01.
  • Massive thanks to fox for creating tt-rss, and maintaining it (and absolutely everything else that went along with it) for so many years.
• This project (https://github.com/tt-rss/tt-rss) is a fork of tt-rss as of 2025-10-03, created by one of its long-time contributors (wn_/wn_name on tt-rss.org, supahgreg on github.com).
  • The goal is to continue tt-rss development, with an initial focus on getting things working as expected without tt-rss.org.
  • Developer note: Due to use of invalid@email.com on supahgreg's pre-2025-10-03 commits (which were done on tt-rss.org) GitHub incorrectly shows ivanivanov884 (the GitHub user associated with that e-mail address) as the author instead of wn_/supahgreg. Apologies for any confusion. ¯\_(ツ)_/¯
• Plugins that were under https://gitlab.tt-rss.org/tt-rss/plugins have been mirrored to https://github.com/tt-rss/tt-rss-plugin-*.
  • Plugin repository names have changed to get a consistent tt-rss-plugin-* prefix.
• Documentation from https://tt-rss.org has been recreated in https://github.com/tt-rss/tt-rss/wiki .
  • The repository that held the content for https://tt-rss.org was mirrored to https://github.com/tt-rss/tt-rss-web-static . Some content tweaks were made after mirroring (prior to the wiki being set up), and the repository is now archived.
• Docker images (for linux/amd64 and linux/arm64) are being built and published (via GitHub Actions) to:
  • Docker Hub (as supahgreg/tt-rss and supahgreg/tt-rss-web-nginx).
  • GitHub Container Registry (as ghcr.io/tt-rss/tt-rss and ghcr.io/tt-rss/tt-rss-web-nginx).
  • See the installation guide for how the images can be used.

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.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Copyright (c) 2005 Andrew Dolgov (unless explicitly stated otherwise).