summaryrefslogtreecommitdiff
path: root/Home.md
blob: 8ecb5c25746bc203f8294d02a5cc33f8db3a8ebe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
% 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.jpg'></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.jpg'></a>    

## 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

<a href="https://bonusland.co.uk/">Bonusland</a>

<a href="https://bestbonus.co.nz/">BestBonus</a>

## 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 <a href="https://srv.tt-rss.org/oldforum/">here</a>.

## 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 <a href="https://git.tt-rss.org/git/tt-rss/src/master">git master branch</a> 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.