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

Where to get it




python build
python install

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


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


Simple usage involves the following steps:

  1. myrss setup
  2. myrss load < urls
  3. 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.
Print the version information.



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.




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.




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

--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.


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 © 2002 Frank J. Tobin,

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.