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

Screenshots

Features

• Free software, licensed under GNU GPLv3
• 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
  • 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
  • Plugins and themes
  • embedding full article content via readability and site-specific plugins
  • deduplication, including perceptual hashing for images
  • podcasts
  • flexible article filtering
  • JSON API
  • and much more…
• Android Client

Installation

You will need the following:

• A modern web browser. This generally means a recent version of Chrome/Chromium or Firefox.
• A system running Docker.

See the Installation Guide for detailed instructions.

If you choose to run tt-rss without using Docker support might be limited.

Tiny Tiny RSS uses a continuous development model based on the main branch, which is considered stable. It’s strongly recommended that you remain current– meaning using either the most recent Docker image(s) or commit on main.

Get in touch

• Go to https://github.com/tt-rss/tt-rss/discussions if you have questions or want to discuss something.
• Go to https://github.com/tt-rss/tt-rss/issues if you want to report an issue, request an enhancement/feature, etc.

Documentation

Browse the documentation:

• Installation Guide
• API Reference
• Plugins and Making Plugins
• Themes
• Content Filters
• FAQ
• Global Configuration

Development and Contributing

• Contributions (documentation improvements, 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.

---

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