MyRSS

Introduction

MyRSS is a simple RSS feed gatherer and printer. The output of MyRSS is an XHTML document that is marked up heavily so that you can tweak the display with CSS easily. An example output document is available at http://myrss.sourceforge.net/example.html

Where to get it

Homepage: http://myrss.sourceforge.net/
Downloads: https://sourceforge.net/project/showfiles.php?group_id=60791

Prerequisites

Installation

python setup.py build
python setup.py install

You might want to copy the myrss.css file that is provided as an example to someplace useful.

Usage

myrss [--db dir] load|print|setup [command-options]

Overview

Simple usage involves the following steps:

myrss setup
myrss load < urls
myrss print > rss.html

Suggestion: run the load and print after each other periodically from cron, e.g., once an hour.

Global Options

--db dir: Location of the database directory. Defaults to ~/.myrss.db. If $HOME is unset, then defaults to .myrss.db in the current director, and issues a warning.
-h, --help: Show help.
--version: Print the version information.

Commands

`setup`

Initializes the database. This is the first command that should be run in order to use MyRSS. Will create the directory if it doesn't exist.

Options

None

`load`

Reads a list of newline-separated URLs on standard input (stdin) and loads information about them into the database. Lines beginning with # or are entirely whitespace are ignored.

Options

None

`print`

Consults the database and write out an XHTML document to standard output (stdout) with the RSS items.

Options

--age age: Only show items which were loaded less than age seconds ago. If age is 0, then show all items.
--title name: Use name as the title of the document. Defaults to "MyRSS".
--css url: Use url as the location of the CSS document linked to. Defaults to "myrss.css" (the name of the example bundled CSS file; though, of course, it would have to be in the current directory). This is merely a string and MyRSS does not try to resolve the URL in any way; it's meant for the XHTML+CSS renderer the views the output.

Changing the rendering of the output

The output that MyRSS gives is heavily marked-up, allowing you to reference many of the types of elements in it easily. Looking at the sample myrss.css file provided in the distribution or simply the class attributes of the elements should provide enougn reference to learn by.

Inspiration

The inspiration for MyRSS was the O'Reilly Network's Meerkat. I wanted a simple standalone replacement where I could provide the URLs and incur less bandwidth because the output is residing on my system.

Copyright

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.