ginger

a web based rss news reader
current release: 2.0.1240
state: production-stable
ginger

About

Ginger is a news reader for rss news feeds. Once it is hosted in a web server, a user can login and read her news in the web browser.

Features:

  • multi-user web application
  • multiple news feeds per user
  • message tagging
  • powerful message filtering
  • very customizable
  • scripting interface

It is based on Django and Python and is real-world tested to run in Apache with the wsgi module on Debian Linux.

License

ginger is distributed under the terms of the GPLv3 or higher license. This also affects all included files without a license header (non-source files like images), unless they are explicitly mentioned as third-party content. Read the Dependencies section for included third-party stuff.

Documentation

The following documentation is available:

Manual

Developer Documentation

Download

The following packages are available. Choose the one which matches your operating system or environment. Please also check for requirements.

Debian/Ubuntu package

sha256sum: 3b6caab635ae691499b4936b3177c1e6a2e60acb4ba5333667d3d8ab4e116adf
created: 2018-08-03 22:37        size: 251.2 KB
sha256sum: 13ff910dee33090766e194babe474579440a9b081700420a61af0d131ccc0b01
created: 2016-10-01 00:09        size: 388.6 KB
sha256sum: 24c61d2bb791f1787d23100cb539e8e6e58dd5ec9c9a178ff736330e4b3bf385
created: 2015-06-18 00:46        size: 285.1 KB
 

Python wheel package

sha256sum: b9f8bf7d6b7647a29dcca63a90dfc6c1c935560b59cb28fdb3d89310f673a1a8
created: 2018-08-03 22:37        size: 2.7 MB
sha256sum: f7622370fc1377577a45e7c813bc06eaca51cbcbdd6c755c0b62d61de67abef7
created: 2016-10-01 00:09        size: 2.2 MB
 

Windows package

sha256sum: b43af6118924371b0e14a6397d9221470d860bb48ccfaaf6ec5984fc69b4a1c6
created: 2018-08-03 22:37        size: 2.9 MB
sha256sum: c2b1c55c68d9dac8ff71964e2b4c2aa02261693ac5cc9242e02b41f581c66867
created: 2016-10-01 00:09        size: 2.4 MB
sha256sum: 7498de6da706f1f3b42bb6c0c0b6782c5acf3ccdd98fb48a938b946a7ea02f3a
created: 2015-06-18 00:46        size: 2.0 MB
 

appc container image

sha256sum: 501848a83ff1a2fb91144712c2d623d9744165693ca1b93b1c981b4c9f1ed635
created: 2018-08-03 22:38        size: 107.5 MB
 

source tarball

sha256sum: c43b21cc6790e45effb48a28c3667efee998415c1f50571e556c5bb431988d20
created: 2018-08-03 22:38        size: 2.8 MB
sha256sum: f9d10f413a391d5c9a7960966a559910c2314adcb8758fb93f11630c5a9cf38b
created: 2016-10-01 00:09        size: 2.3 MB
sha256sum: 66c853c48b0d47d66a35a4f371281102008981ba5b3726dca291dbdf227ad043
created: 2015-06-18 00:46        size: 1.9 MB
 

There are external parts which are used by ginger. Many thanks to the projects and all participants.
python.png
Python 3.4 required
django.png
Django 1.8 required
linux.png
Typical GNU/Linux Desktop recommended
package.png
python-feedparser required
apache.png
apache 2.4 recommended : as web server
package.png
mod_wsgi recommended : apache module
jquery.png
jquery included : licensed under terms of GPLv2.
artwork.png
PT Sans Font included : as included in Webix.
artwork.png
font 'Symbola' included : for logo symbol; free for use; copied from here.
artwork.png
banner image included : _meta/homepage_bannerimage.png; license public domain; copied from here.
artwork.png
all files in /_meta included : if not mentioned otherwise, Copyright 2015 Josef Hahn under license CC BY-SA 3.0 license.

Gallery

screenshot.1.png
Ginger on mobile phones
screenshot2.png
The Ginger login screen
screenshot3.png
The main view, containing a message list and a filter panel
screenshot4.png
Settings
screenshot5.png
Feed management
gallery0/v_ginger001.mp4|||Screencast: First steps
gallery0/v_ginger002.mp4|||Screencast: Favorites and tagging
gallery0/v_ginger003.mp4|||Screencast: Filters
gallery0/v_ginger004.mp4|||Screencast: Scripting

Change Log

The last changes brought the following improvements.

2017-03-14 (2.0.932)
  • More modern user interface.

Imprint

Publisher: Josef Hahn, Boxgraben 112-114, 52064 Aachen, Germany | website: pseudopolis.eu/wiki/pino | mail: ginge.nosp@m.r@ps.nosp@m.eudop.nosp@m.olis.nosp@m..eu

Feedback

If you have funny rants about ginger itself or about some techniques it uses, some constructive feedback, a cool patch or a mysterious problem, feel free to mail it to ginge.nosp@m.r@ps.nosp@m.eudop.nosp@m.olis.nosp@m..eu.

Please use the bugtracker if you have found an error in the software.