% Tiny Tiny RSS

Tiny Tiny RSS is a free and open source web-based news feed (RSS/Atom) reader and aggregator

<a href='https://tt-rss.org/images/ttrss/18.12/1812-shot5.png'>
    <img src='https://tt-rss.org/images/ttrss/18.12/1812-shot5_small.png'></a>
<a href='https://tt-rss.org/images/ttrss/18.12/1812-shot1.png'>
    <img src='https://tt-rss.org/images/ttrss/18.12/1812-shot1_small.png'></a>    

### Sponsored by

(Contact [me](mailto:cthulhoo@gmail.com) if you're interested in placing a link here)

## 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://tt-rss.org/tt-rss-android) ([Apkmonk](https://www.apkmonk.com/app/org.fox.ttrss/)) ([F-Droid repo](https://discourse.tt-rss.org/t/f-droid-repository-for-tt-rss/1321))

## Get in touch

* **[Read the FAQ before asking questions](wiki/FAQ)**
* Join [community forums](https://discourse.tt-rss.org/) or [jabbber group chat](https://discourse.tt-rss.org/t/come-idle-with-us-on-jabber-xmpp/1886) if you have any questions, comments or bug reports.
* Previous (phpbb) forum archive is available <a href="https://srv.tt-rss.org/oldforum/">here</a>.

## Contributing

* If you're interested in contributing code, check [this page](https://git.tt-rss.org/git/tt-rss/src/master/CONTRIBUTING.md). 
* If you want to help translate tt-rss to your language, go [here](https://weblate.tt-rss.org/projects/).

<a href="http://weblate.tt-rss.org/engage/tt-rss/?utm_source=widget">
<img src="http://weblate.tt-rss.org/widgets/tt-rss/-/svg-badge.svg" alt="Translation status" />
</a>

## Requirements

* A modern web browser. As of 2018, this generally means recent Chrome or compatible. Firefox should also work.
* Dedicated web hosting account (i.e. a VDS or a physical server) running [LAMP](http://en.wikipedia.org/wiki/LAMP_(software_bundle)) stack.

Everything else, including but not limited to, shared hosting accounts, windows and other 
alternative OSes, NAS boxes, PaaS services of any kind, alternative web browsers (or old browser versions), 
is not supported. That is, it may work for you but if you run into problems you are on your own.

Additionally, 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 [MySQL](http://www.mysql.com) (InnoDB is **required**).

## Download

Tiny Tiny RSS uses a rolling release model based on <a href="https://git.tt-rss.org/git/tt-rss/src/master">git master branch</a> which is considered stable.

**Note:** if you can't check out from main git repository (one common reason is Cloudflare disliking your IP), try using Gitlab mirror [here](https://gitlab.com/gothfox/tt-rss).

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.