Snownews is a command-line RSS feed reader. It runs on everything Unix.
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
contrib Improve build system Apr 26, 2018
man Make configure options --with-debug and --without-nls work Apr 30, 2018
po Make configure options --with-debug and --without-nls work Apr 30, 2018
scripts Improve build system Apr 26, 2018
.gitignore Improve build system Apr 26, 2018
AUTHOR Import the old snownews code into git. The old hg repo blew up anyway… Jul 2, 2015
COPYING Relicensing to GPL-3.0 Oct 23, 2017
CREDITS Import the old snownews code into git. The old hg repo blew up anyway… Jul 2, 2015
Changes Import the old snownews code into git. The old hg repo blew up anyway… Jul 2, 2015
Config.mk.in Add standalone MD5 implementation to remove openssl dependency. Closes Jun 5, 2018
Makefile General cleanup Apr 30, 2018
README.md Add standalone MD5 implementation to remove openssl dependency. Closes Jun 5, 2018
about.c Move all global variabls to main.c Apr 30, 2018
about.h Merge support.c into about.c. This fixes #17. Apr 30, 2018
categories.c Sort struct members by type to improve packing Apr 30, 2018
categories.h Move all global variabls to main.c Apr 30, 2018
config.h.in Add SNOWNEWS_CONFIG_DIR and SNOWNEWS_CACHE_DIR in config.h to replace… Apr 30, 2018
configure Bump version number Jul 29, 2018
conversions.c Add standalone MD5 implementation to remove openssl dependency. Closes Jun 5, 2018
conversions.h Add standalone MD5 implementation to remove openssl dependency. Closes Jun 5, 2018
cookies.c Add SNOWNEWS_CONFIG_DIR and SNOWNEWS_CACHE_DIR in config.h to replace… Apr 30, 2018
cookies.h Replace header guards with the universally supported pragma once Apr 27, 2018
dialog.c Add SNOWNEWS_CONFIG_DIR and SNOWNEWS_CACHE_DIR in config.h to replace… Apr 30, 2018
dialog.h Move all global variabls to main.c Apr 30, 2018
digcalc.c Add standalone MD5 implementation to remove openssl dependency. Closes Jun 5, 2018
digcalc.h Add standalone MD5 implementation to remove openssl dependency. Closes Jun 5, 2018
filters.c Sort struct members by type to improve packing Apr 30, 2018
filters.h Move all global variabls to main.c Apr 30, 2018
interface.c Set feed mtime from marking item read only when it was unread. Jun 4, 2018
interface.h Replace header guards with the universally supported pragma once Apr 27, 2018
io-internal.c Fix clang's warnings about syslog format security May 2, 2018
io-internal.h Remove output to error.log file Apr 30, 2018
main.c Improve random number seeding Apr 30, 2018
main.h Reduce writes to ~/.snownews Apr 30, 2018
md5.c Add standalone MD5 implementation to remove openssl dependency. Closes Jun 5, 2018
md5.h Add standalone MD5 implementation to remove openssl dependency. Closes Jun 5, 2018
net-support.c General cleanup Apr 30, 2018
net-support.h Move all global variabls to main.c Apr 30, 2018
netio.c Fix clang's warnings about syslog format security May 2, 2018
netio.h Move all global variabls to main.c Apr 30, 2018
opml2snow Import the old snownews code into git. The old hg repo blew up anyway… Jul 2, 2015
os-support.c Move all global variabls to main.c Apr 30, 2018
os-support.h Move all global variabls to main.c Apr 30, 2018
setup.c Add SNOWNEWS_CONFIG_DIR and SNOWNEWS_CACHE_DIR in config.h to replace… Apr 30, 2018
setup.h Reduce writes to ~/.snownews Apr 30, 2018
snowsync Import the old snownews code into git. The old hg repo blew up anyway… Jul 2, 2015
ui-support.c Fix new warnings from gcc 8.1 May 9, 2018
ui-support.h Remove output to error.log file Apr 30, 2018
xmlparse.c Sort struct members by type to improve packing Apr 30, 2018
xmlparse.h Move all global variabls to main.c Apr 30, 2018
zlib_interface.c General cleanup Apr 30, 2018
zlib_interface.h General cleanup Apr 30, 2018

README.md

Snownews

What it is

Snownews is a command-line RSS feed reader. It is designed to be simple and lightweight, and integrates well with other command-line tools, for both generating and filtering the feeds it reads. Snownews runs on almost anything Unix (and will even build with Cygwin).

Features

  • Runs on Linux, BSD, OS X (Darwin), Solaris and probably many more Unices. Yes, even works under Cygwin.
  • Fast and very resource friendly.
  • Builtin HTTP client will follow server redirects and update feed URLs that point to permanent redirects (301) automatically.
  • Understands "Not-Modified" (304) server replies and handles gzip compression.
  • Uses local cache for minimal network traffic.
  • Supports HTTP proxy.
  • Supports HTTP authentication (basic and digest methods).
  • Supports cookies.
  • A help menu available throughout the program.
  • Few dependencies on external libraries; ncurses and libxml2.
  • Import feature for OPML subscription lists.
  • Fully customizable key bindings of all program functions.
  • Type Ahead Find for quick and easy navigation.
  • Color support.
  • Extensible via plugins.
  • Feed categories and many other useful features!

Building Snownews

You will need the following:

  • GCC compiler 5+
  • ncurses 5.0+
  • libxml2
  • Perl (for extension scripts)
  • gettext (lib and msgfmt tool)

Simply do the following steps:

./configure
make
sudo make install

By default, this will install Snownews into /usr/local. If you prefer it to go somewhere else, set the ./configure --prefix=DIR parameter. configure --help will list other options that you may find interesting. For example, if you're on Arch, you would do:

./configure --prefix=/usr
sudo make install

How to use it

Snownews comes with a complete man page, where you can find all the details for its use. If you prefer a tutorial, you can find one here. The man page is available in English, German, Dutch and French at the moment.

A set of helper scripts, made for Snownews by various contributors, can be found in the contrib directory, along with instructions for their use.

Contributing

If you would like to contribute to Snownews, consider fixing one of our issues, adding a helper script, or writing a localization. If you are interested in contributing a helper script, please read contrib/CONTRIBUTING.md for details.

Localization

Snownews and its documentation is currently available in the following languages:

  • Belarusian Latin
  • Chinese, Traditional
  • Chinese, Simplified
  • Dutch
  • English
  • French
  • German
  • Italian
  • Japanese
  • Korean
  • Polish
  • Portuguese, Brazilian
  • Russian
  • Slovenian
  • Spanish
  • Swedish

If you want to create a new translation or update an exisiting one, send a patch or a pull request on github.

License

Snownews is licensed under the GNU General Public License, version 3 only (SPDX code GPL-3.0). For more details, as well as the text of the license, please see the COPYING file.