Skip to content

newsrudder - drive the news boat

[Home | GitLab | crates.io | ReadTheDocs]

Overview

The newsrudder tool makes a feeble attempt to synchronize the RSS feed items downloaded by Newsboat on a remote server with the locally-read ones. It has been developed specifically for the needs of its author and it is probably of no use to anybody else.

Quick start

  1. Install and configure newsboat on a remote server.
  2. Configure the remote server to run newsboat -x reload periodically; a sample systemd timer and one-shot service can be found in the files/systemd/user/ directory.
  3. Configure newsboat locally; probably set both auto-reload and refresh-on-startup to no.
  4. Run newsrudder show boat to make sure newsrudder can see your local newsboat configuration.
  5. Run newsrudder remote -r user@host fetch to make sure newsrudder can access the remote server.

Then, periodically:

  1. Stop your local newsboat instance.
  2. Run newsrudder remote -r user@host fetch.
  3. Run newsrudder remote -r user@host insert-new.
  4. Start newsboat again, enjoy your new articles.

To do

At least check that the local newsboat cache contains all the same feeds fetched from the remote server; right now adding feeds to the remote server and not adding them locally will result in weirdly orphaned articles.

Run newsrudder features on the remote server instead of unconditionally copying ourselves over for the remote fetch command.

Check the local cache's metadata table to figure out whether we should omit some columns in the SQL INSERT statement.

Contact

The newsrudder tool was written by Peter Pentchev. It is developed in a GitLab repository. This documentation is hosted at Ringlet with a copy at ReadTheDocs.