The lists folder

  1. A subscription list is an OPML file in the lists folder of your River4 data folder.

  2. Each list corresponds to a river. The feeds in the list are the feeds we read to find new items for the corresponding river.

  3. Suppose you wanted a river of news about movies. You'd create an OPML file in the lists folder called movies.opml. River4 would read the feeds in that list periodically, and put the new items in the riverjs file in the rivers folder. The river file is called movies.js.

  4. To edit the list you can use a text editor, to hand-edit the OPML, or you can use an outliner whose native format is OPML.

Using Fargo to edit OPML lists

My outliner, Fargo is perfectly suited for editing OPML subscription lists.

  1. First create a new outline, using the File/New command in Fargo.

  2. Create a new headline by pressing Return. Type a short description. Choose Add Feed in the Outliner menu, and paste the URL of an RSS or Atom feed. Repeat this for all the feeds you want to add to your list.

  3. If you want to include another OPML list in this list, press Return to add a new headline. Type a short description, then choose Add Include in the Outliner menu, and enter the URL an OPML file. When River4 processes the list, it will be as if all the feeds in that list were in this list. Here's a Fargo docs page on includes.

  4. You can use the include feature in the previous step to create a placeholder list in your lists folder. Just have it include the list you're editing in Fargo. You can get the URL of the outline by choosing Get Public Link in Fargo's File menu. This is a bit complicated, but worth studying and understanding because it makes Fargo a simple way to tell River4 what feeds you want it to read.

Managing multiple rivers

It's easy to have a second or third river, just create another OPML file in lists folder. It's probably good to get started with a single list, and get a feel for how busy the feeds are, how many new items you get every time you look at the river.

08/04/15; 11:14:38 AM

This is a checklist I've used for installing River4 on a fresh Ubuntu v14.04 server.

Install node.js

sudo apt-get update

sudo apt-get install nodejs

sudo apt-get install npm

sudo apt-get install nodejs-legacy

We also install npm, a requirement to run Node apps.

nodejs-legacy makes it possible to run apps by saying node app.js instead of having to use nodejs, an oddity of Ubuntu.

Install forever

sudo npm install forever -g

There are lots of ways to get apps to launch in the background, I like forever because it keeps the app running even if it crashes. River4, of course, never crashes (heh) but you never really know.

Install git

sudo apt-get install git

I like to install git, because it makes it easy to install River4 from GitHub.

Install River4

git clone https://github.com/scripting/river4.git

That should create a directory containing River4 at /home/ubuntu/river4

To run it, follow the instructions on the River4 howto.

08/04/15; 09:10:16 AM

Last built: Sun, Nov 8, 2015 at 2:12 PM

By Dave Winer, Tuesday, August 4, 2015 at 9:10 AM.