% Tiny Tiny RSS
#### Tiny Tiny RSS is a free and open source web-based news feed (RSS/Atom) reader and aggregator
## Features
- Server-side AJAX-powered application, user only needs a web browser.
- Free software, licensed under [GNU
GPLv3](http://www.gnu.org/copyleft/gpl.html)
- Self-hosted: control your own data and protect your privacy instead of relying on [third party services](https://duckduckgo.com/?q=if+it%27s+free+you+are+the+product&t=h_&ia=web)
- Supports
- [feed aggregation / syndication](wiki/GeneratedFeeds),
- keyboard shortcuts,
- OPML import/export,
- multiple ways to share stuff: via RSS feeds, using plugins to
various social sites, sharing by URL, etc,
- [sharing arbitrary content through tt-rss](wiki/ShareAnything),
- internationalization,
- [Plugins](wiki/Plugins) and [themes](wiki/Themes),
- embedding full article content via readability and site-specific plugins,
- detecting and filtering duplicate articles,
- podcasts,
- [flexible article filtering](wiki/ContentFilters),
- [JSON-based API](wiki/ApiReference),
- and much more…
- Official [Android client](https://play.google.com/store/apps/details?id=org.fox.ttrss) ([Apkmonk](https://www.apkmonk.com/app/org.fox.ttrss/), **[F-Droid](https://srv.tt-rss.org/fdroid/#org.fox.ttrss)**, [Source](https://git.tt-rss.org/fox/tt-rss-android))
## Sponsored by
Bonusland
BestBonus
## Demo
See [here](https://srv.tt-rss.org/tt-rss/) (login as ``demo``, ``demo``)
* Runs using [stock docker setup](https://git.tt-rss.org/fox/ttrss-docker-compose).
* Database is automatically restored every two hours.
## Get in touch
* **[Read the FAQ before asking questions](wiki/FAQ)**
* Join [community forums](https://discourse.tt-rss.org/) if you have any questions, comments or bug reports.
* [Telegram channel](https://t.me/TinyTinyRSS)
* Previous (phpbb) forum archive is available here.
## Contributing
If you're interested in contributing code or translations, check [this page](https://git.tt-rss.org/git/tt-rss/src/master/CONTRIBUTING.md).
## Requirements
* A modern web browser. This generally means recent Chrome or compatible.
* A server (VDS or physical) running either Docker or [LEMP](https://lemp.io/) stack.
When installing directly on a host machine you will need:
* PHP version **5.6** or newer ([detailed PHP requirements](wiki/PhpCompatibilityNotes))
* [PostgreSQL](http://www.postgresql.org) (**9.1** or newer, **[recommended](wiki/FAQ#what-should-i-use---mysql-or-postgresql)**) or [MariaDB](https://mariadb.org/) (InnoDB is **required**).
## Download
Tiny Tiny RSS uses continuous development model based on git master branch which is considered stable. If possible, you should always be running latest master branch code.
There’s no warranty. If it breaks you get to keep both parts.
Please read the [installation guide](wiki/InstallationNotes) and [updating feeds](wiki/UpdatingFeeds) before installing.
## Features
- Server-side AJAX-powered application, user only needs a web browser.
- Free software, licensed under [GNU
GPLv3](http://www.gnu.org/copyleft/gpl.html)
- Self-hosted: control your own data and protect your privacy instead of relying on [third party services](https://duckduckgo.com/?q=if+it%27s+free+you+are+the+product&t=h_&ia=web)
- Supports
- [feed aggregation / syndication](wiki/GeneratedFeeds),
- keyboard shortcuts,
- OPML import/export,
- multiple ways to share stuff: via RSS feeds, using plugins to
various social sites, sharing by URL, etc,
- [sharing arbitrary content through tt-rss](wiki/ShareAnything),
- internationalization,
- [Plugins](wiki/Plugins) and [themes](wiki/Themes),
- embedding full article content via readability and site-specific plugins,
- detecting and filtering duplicate articles,
- podcasts,
- [flexible article filtering](wiki/ContentFilters),
- [JSON-based API](wiki/ApiReference),
- and much more…
- Official [Android client](https://play.google.com/store/apps/details?id=org.fox.ttrss) ([Apkmonk](https://www.apkmonk.com/app/org.fox.ttrss/), **[F-Droid](https://srv.tt-rss.org/fdroid/#org.fox.ttrss)**, [Source](https://git.tt-rss.org/fox/tt-rss-android))
## Sponsored by
Bonusland
BestBonus
## Demo
See [here](https://srv.tt-rss.org/tt-rss/) (login as ``demo``, ``demo``)
* Runs using [stock docker setup](https://git.tt-rss.org/fox/ttrss-docker-compose).
* Database is automatically restored every two hours.
## Get in touch
* **[Read the FAQ before asking questions](wiki/FAQ)**
* Join [community forums](https://discourse.tt-rss.org/) if you have any questions, comments or bug reports.
* [Telegram channel](https://t.me/TinyTinyRSS)
* Previous (phpbb) forum archive is available here.
## Contributing
If you're interested in contributing code or translations, check [this page](https://git.tt-rss.org/git/tt-rss/src/master/CONTRIBUTING.md).
## Requirements
* A modern web browser. This generally means recent Chrome or compatible.
* A server (VDS or physical) running either Docker or [LEMP](https://lemp.io/) stack.
When installing directly on a host machine you will need:
* PHP version **5.6** or newer ([detailed PHP requirements](wiki/PhpCompatibilityNotes))
* [PostgreSQL](http://www.postgresql.org) (**9.1** or newer, **[recommended](wiki/FAQ#what-should-i-use---mysql-or-postgresql)**) or [MariaDB](https://mariadb.org/) (InnoDB is **required**).
## Download
Tiny Tiny RSS uses continuous development model based on git master branch which is considered stable. If possible, you should always be running latest master branch code.
There’s no warranty. If it breaks you get to keep both parts.
Please read the [installation guide](wiki/InstallationNotes) and [updating feeds](wiki/UpdatingFeeds) before installing.