====== Tiny Tiny RSS ======

===== Introduction =====

With Google announcing the end of Google Reader, SDF brought its own alternative to RSS reading: our own instance of //Tiny Tiny RSS//(([[http://tt-rss.org/|Tiny Tiny RSS]], //a free and open source web-based news feed (RSS/Atom) reader and aggregator//)). It's a RSS service much like Google Reader, with many options of customization, sharing, filtering, etc. //SDF's server((Accounts in SDF's [[menu_of_sdf_offerings|tiny tiny RSS]] server are available upon request.))// is hosted [[https://rss.sdf.org|here]].

===== Activation and Configuration =====

As with any other social service of SDF, it comes disabled by default. To enable it on your account, email membership@sdf.org. It is available to MetaARPA members.

After the service is enabled, make sure to change the default password (Actions -> Preferences -> Personal data/Authentication). If you have your old feed subscriptions exported from Google Reader, you can upload them here (Actions -> Preferences -> Feeds -> Import and export) or subscribe to new ones (Actions -> Subscribe to feed).

{{:tiny_tiny_rrs:ttrss_passwd.png?nolink&800|Example}}

Browsing and reading RSS feeds are similar to using Google Reader and other web-based RSS readers. There are many options to fine-tune how it behaves, see Actions -> Preferences for more.

===== External clients =====

This service provides an API enabling external clients to connect to it and interact. Be sure to enable the external API support before trying to use an external client.

{{:tiny_tiny_rrs:ttrss_api.png?nolink&800|Example}}

==== Fever API Plugin ====

This plugin, if enabled, allows third party clients to connect to SDF's tt-rss via the fever API.

To enable, navigate to Actions -> Preferences -> Plugins; check the box next to "fever", and click "Enable selected plugins". Once enabled, you will find the "Fever Emulation" menu under the Preference's Preferences tab. You will need to set a password.

{{:tiny_tiny_rrs:ttrss_fever_api.png?nolink&800|Example}}


==== Newsboat ====
[[https://github.com/newsboat/newsboat|Newsboat]] is an actively maintained fork of Newsbeuter. It has support for ttrss and can be configured in the same manner as Newsbeuter:

<code>

urls-source "ttrss"

ttrss-url "https://rss.sdf.org/"
ttrss-mode multi
ttrss-login "username"
ttrss-password "password"

</code>

''<del>ttrss-url <nowiki>"https://sdf.org/ttrss/"</nowiki></del>''

==== Newsbeuter (Deprecated) ====

[[http://www.newsbeuter.org/|Newsbeuter]] is a feed reader for text terminals. Even though newsbeuter 2.6 has support for ttrss, newer versions of the latter broke the external API, so to connect to the SDF's server you will need to compile the code from git or wait until version 2.7 comes out.

<code>

urls-source "ttrss"

ttrss-url "https://rss.sdf.org/"
ttrss-mode multi
ttrss-login "username"
ttrss-password "password"

</code>

''<del>ttrss-url <nowiki>"https://sdf.org/ttrss/"</nowiki></del>''

----

$Id: ttrss.html,v 1.7 2014/03/06 23:09:16 edgchacon Exp $ [[http://sdf.org/?tutorials/ttrss | Tiny Tiny RSS]] - traditional link (using [[wp>Revision_Control_System|RCS]])