FreedomBox/doc/manual/en/TinyTinyRSS.raw.wiki
James Valleroy fc0ce69ddb
doc: Fetch latest manual
Signed-off-by: James Valleroy <jvalleroy@mailbox.org>
2022-06-20 20:51:27 -04:00

150 lines
6.3 KiB
Plaintext

#language en
##TAG:TRANSLATION-HEADER-START
~- [[FreedomBox/Manual/TinyTinyRSS|English]] - [[es/FreedomBox/Manual/TinyTinyRSS|Español]] - [[DebianWiki/EditorGuide#translation|(+)]] -~
##TAG:TRANSLATION-HEADER-END
<<TableOfContents()>>
## BEGIN_INCLUDE
== Tiny Tiny RSS (News Feed Reader) ==
||<tablestyle="float: right;"> {{attachment:TinyTinyRSS-icon_en_V01.png|Tiny Tiny RSS icon}} ||
'''Available since''': version 0.9
Tiny Tiny RSS is a news feed (RSS/Atom) reader and aggregator, designed to allow reading news from any location, while feeling as close to a real desktop application as possible.
Any user created through !FreedomBox web interface will be able to login and use this app. Each user has their own feeds, state and preferences.
=== Using the Web Interface ===
When enabled, Tiny Tiny RSS will be available from ''/tt-rss'' path on the web server. Any user created through !FreedomBox will be able to login and use this app.
{{attachment:ttrss.png|Tiny Tiny RSS|width=800}}
==== Adding a new feed ====
1. Go to the website you want the RSS feed for and copy the RSS/Atom feed link from it.
{{attachment:Select-RSS-feed.png|Selecting feeds|width=800}}
2. Select "Subscribe to feed.." from the Actions dropdown.
{{attachment:Subscribe-to-feed.png|Subscribe to feed}}
3. In the dialog box that appears, paste the URL for copied in step 1 and click the '''Subscribe''' button.
{{attachment:Subscribe-dialog.png|Subscription dialog box|width=800}}
Give the application a minute to fetch the feeds after clicking Subscribe.
In some websites, the RSS feeds button isn't clearly visible. In that case, you can simply paste the website URL into the Subscribe dialog (step 3) and let TT-RSS automatically detect the RSS feeds on the page.
You can try this now with the homepage of [[https://en.wikinews.org/wiki/Main_Page|WikiNews]]
As you can see in the image below, TT-RSS detected and added the Atom feed of !WikiNews to our list of feeds.
{{attachment:WikiNews-feed.png|WikiNews feed added}}
If you don't want to keep this feed, right click on the feed shown in the above image, select '''Edit feed''' and click '''Unsubscribe''' in the dialog box that appears.
{{attachment:Unsubscribe.png|Unsubscribe from a feed|width=800}}
==== Importing your feeds from another feed reader ====
In your existing feed reader, find an option to ''Export'' your feeds to a file. Prefer the OPML file format if you have to choose between multiple formats. Let's say your exported feeds file is called Subscriptions.opml
Click on the ''Actions'' menu at the top left corner and select ''Preferences''. You will be taken to another page.
Select the second tab called ''Feeds'' in the top header. Feeds has several sections. The second one is called ''OPML''. Select it.
{{attachment:OPML.png| OPML feeds page|width=960}}
To import your Subscriptions.opml file into TT-RSS,
1. Click ''Browse'' and select the file from your file system
2. Click ''Import my OPML''
After importing, you'll be taken to the '''Feeds''' section that's above the OPML section in the page. You can see that the feeds from your earlier feed reader are now imported into Tiny Tiny RSS. You can now start using Tiny Tiny RSS as your primary feed reader.
In the next section, we will discuss setting up the mobile app, which can let you read your feeds on the go.
=== Using the Mobile App ===
The official Android app from the Tiny Tiny RSS project works with !FreedomBox's Tiny Tiny RSS Server. The older TTRSS-Reader application is known '''not''' to work.
To configure, first install the application, then in the setting page, set URL as ''https://<your.freedombox.address>/tt-rss-app/''. Set your user name and password in the Login details as well as HTTP Authentication details. If your !FreedomBox does not have a valid HTTPS certificate, then in settings request allowing any SSL certificate and any host.
{{attachment:ttrssapp1.png|Tiny Tiny RSS|width=288}}
{{attachment:ttrssapp2.png|Tiny Tiny RSS|width=288}}
{{attachment:ttrssapp3.png|Tiny Tiny RSS|width=288}}
{{attachment:ttrssapp4.png|Tiny Tiny RSS|width=288}}
{{attachment:ttrssapp5.png|Tiny Tiny RSS|width=288}}
=== Subscribing to popular platforms ===
==== YouTube ====
1. On your computer open a text editor and copy-paste the following line:
{{{https://www.youtube.com/feeds/videos.xml?channel_id=</code>}}}
2. Open a video of the channel you would like to subscribe to. In this example we will subscribe to the !FreedomBox Foundation's !YouTube channel.
3. Under the video, right click on the channel's name, and select '''Copy Link'''. You have to make sure you copy the channel's URL this way, as there many channels with custom URL IDs. Copying the link from here will give you the uncustomized ID of the channel.
{{attachment:copy_link_youtube.png|Tiny Tiny RSS|width=960}}
4. Paste this link into your text file as well.
5. Now that you have both links, you should select the text which comes after {{{/channel/}}}, and place it next to the first link as shown in the pictures below.
{{attachment:paste_link_youtube.png|Tiny Tiny RSS|width=800}}
----
{{attachment:valid_youtube_rss_feed.png|Tiny Tiny RSS|width=800}}
6. Now you can use this link as a valid RSS feed.
{{attachment:youtube_final_step.png|Tiny Tiny RSS|width=800}}
In addition, you can make videos display inside Tiny Tiny RSS:
1. Select "Preferences" from the Actions dropdown.
2. Select Plugins
3. Turn on the plugin titled "af_youtube_embed"
4. Click on "Enable selected plugins"
Please note, that it is highly reccommended that you use one of the privacy extensions, like [[https://ublockorigin.com//|uBlockOrigin]] to avoid advertisements and intrusive trackers.
==== Reddit ====
1. Take the link of the subreddit you want to subscribe to
2. Add {{{.rss}}} after the subreddit's url.
For example the subreddit for !FreedomBox is {{{https://www.reddit.com/r/Freedombox/}}}, and {{{https://www.reddit.com/r/Freedombox/.rss}}} will give you an RSS feed.
{{attachment:subscribe_to_subreddit.png|Tiny Tiny RSS|width=800}}
=== External links ===
* Website: https://tt-rss.org
## END_INCLUDE
Back to [[FreedomBox/Features|Features introduction]] or [[FreedomBox/Manual|manual]] pages.
<<Include(FreedomBox/Portal)>>
----
CategoryFreedomBox