voracious

Meta

AUR:32156
Arch Forum Thread:85305
Binary Package:xyne-any/voracious-2010.08.17.1-1-any.pkg.tar.xz
Manpage:manpages/voracious
PKGBUILD:pkgbuilds/voracious
Repos:[xyne-any]
Source Package:voracious-2010.08.17.1.tar.gz
Taurball:voracious.tar.gz
Version:2010.08.17.1

About

Voracious is a customizable web feed aggregator for your browser. Please read the man page for more information.

The following references will be useful for customizing the template:

http://www.feedparser.org/docs/reference.html

http://docs.python.org/library/time.html#time.strftime

Screenshots

Here are some screenshots using the default template file. Note that these are just basic examples and that you can fully customize both the display and the content of all feeds.

voracious screenshot voracious screenshot voracious screenshot voracious screenshot voracious screenshot

Example

Here's a simple example which shows how to use the $CLASS$ tag to assign colors to different feeds.

Configuration File

[paths]
/example
  http://feeds.arstechnica.com/arstechnica/index
  http://www.archlinux.org/feeds/news/
  http://www.merriam-webster.com/word/index.xml
  http://xkcd.com/rss.xml



[classes]
arch
  archlinux
ars
  arstechnica
slashdot
  slashdot
xkcd
  xkcd

Template File

<html>
  <head>
    <style type="text/css">
    body {
      margin-left: 205px;
      background: #333;
    }
    #navbar {
      color: black;
      background: #d8d8d8;
      align: left;
      margin-left: -200px;
      width: 190px;
      position: absolute;
      padding-bottom: 5px;

    }
    .navlink {
      color: inherit;
      display: list-item;
      align: left;
      margin: 2px 20px;
    }
    #editlink {
      margin: 2px 20px;
    }
    .item {
      background: #d8d8d8;
      margin: 20px auto;
      text-align: justify;
    }
    .item_title {
      color: #eee;
      background: #666;
      padding: 5px 10px;
      font-weight: bold;
      border-bottom: solid 2px black;
    }
    .item_meta {
      font-weight: bold;
      padding: 5px 10px;
    }
    .item_title a {
      color: inherit;
      text-decoration: none;
    }
    .item_summary {
      padding: 20px;
    }
    .arch .item_title{
      background: #1793D1;
    }
    .ars .item_title{
      background: #EA3800;
    }
    .slashdot .item_title{
      background: #006666;
    }
    .xkcd .item_title{
      background: #6E7B91;
    }
    </style>
  </head>
  <body>
    <div id="navbar">
      <div class="item_title">Navbar</div>
      $NAVLINKS$
      <br/>
      $EDITLINK$
    </div>
    $ITEM$
      <div class="item $CLASS$">
        <div class="item_title"><a href="$entry.link$">$feed.title$ : $entry.title$</a></div>
        <div class="item_meta">$entry.date$</div>
        <div class="item_summary">$entry.summary$</div>
      </div>
    $/ITEM$
  </body>
</html>

Changelog

2010-08-17

  • Corrected "bug" in template file: $entries.*$ is now $entry.*$, as originally intended.
  • Included some changes submitted or inspired by Ben Holroyd
    • parameterized feed and entry tags
      • fallback content
      • maximum content length
    • avoid parsing tags inside HTML comments in template file

The parameterized tags use a CSS-like syntax, e.g. $value:entry.summary;max:100$. Check the man page for details.

If you are using the default template file, simply delete it and Voracious will create a new version. The default template file is located at $XDG_CONFIG_HOME/voracious/template.htm, or ~/.config/voracious/template.htm if $XDG_CONFIG_HOME is not set.

Submitted Changes

You can find changes submitted by others that have not yet been incorporated into Voracious here.

/home/projects/voracious ●─┐
     ┌─────────────────────┘
     └─▶ submitted_changes/