wiki.ryliejamesthomas.net

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== FreshRSS ======
**FreshRSS** is an {{tagpage>open-source}} [[rss]] reader you can self-host. I'm currently running it on my NAS, 'cause there's an easy package for it in the QNAP Club repo. The easiest way to set it up was with the SQL database, the other options took extra configuring from QApache.

FreshRSS gives you a web frontend you can keep in a tab in your browser. You can also enable support for the GReader and Fever APIs, which make it easy to use with other clients. I've found [[EasyRSS]], which is on [[F-Droid]], works well with GReader API enabled :)

Be warned that the documentation/help is very incomplete.

===== Adding Feeds =====

==== Full Article ====

It's obscured by the English translation, but you //can// get full articles from places like [[Blogger]] that only provide summeries.

When editing a feed scroll down to the 'Advanced' section, then find the field labelled 'Article CSS selector on original website'. You need to go to an article and find the [[html]] element that contains the content you want, than grab something unique you can use to identify it (an //element//, //ID//, or //class//) and add them to the field in the same format you would in a [[CSS]] file. So ''#whatever'' for an ID, and ''.whatever'' for a class. You can click the eye icon to get a preview.

Here're some ones I use:

  * [[Blogger]]:
    * [[https://lunaticobscurity.blogspot.com/|Lunatic Obscurity]]: ''.post-body''
  * [[Mastodon]] (with content warning): //Haven't found one//
  * [[Wordpress]]:\\ Most should use ''article'', but it depends on version and theme.
    * [[https://www.bomphcast.com/|Bomphcast]]: ''.post-content''
    * [[https://meanjin.com.au/|Meanjin]]: ''article''
    * [[https://overland.org.au/|Overland]]: ''article''
    * [[https://wfgames.net/games/|Weird Fucking Games]]: ''article''

nbjp Blogger and Wordpress can send full articles themselves, but it depends how things're setup.\\

Source: https://freshrss.github.io/FreshRSS/en/users/04_Subscriptions.html#retrieve-a-truncated-feed-from-within-freshrss

===== Automation =====
To automatically refresh the feeds you have to use a //[[cron]] job//.

To do this on a QNAP NAS [[SSH]] into your server and add a line to the ''crontab'' file at ''/etc/config/crontab'' as described in their documentation: [[github>FreshRSS/FreshRSS#automatic-feed-update|Automatic Feed Update]].

On my NAS I use this line:

''11 * * * * /share/CACHEDEV1_DATA/.qpkg/FreshRSS/freshrss/app/actualize_script.php > /share/CACHEDEV1_DATA/.qpkg/FreshRSS/FreshRSS.log 2>&1''

Which updates the feeds at the eleventh minute of every hour and adds an entry to FRSS's log.

==== See Also ====
  * https://lab.uberspace.de/guide_freshrss.html
  * http://adriank.org/qnap-how-to-modify-crontab-to-addedit-jobs-in-cron/
  * https://www.techandme.se/qnap-and-cron/
  * https://wiki.qnap.com/wiki/Add_items_to_crontab

===== Extensions =====

  * [[github>FreshRSS/Extensions]] - Official extension collection.
  * [[github>DevonHess/FreshRSS-Extensions/tree/main/xExtension-RssBridge]] - Incorporate [[RSS-Bridge]].

===== See Also =====
  * [[https://www.freshrss.org/|freshrss.org]]
  * [[github>FreshRSS]] on Github.
  * [[firefox#RSS|Firefox §RSS]] - info on integrating RSS readers.

{{tag>guide open-source RSS self-hosting software}}