ginger

a web based rss news reader
current release: 2.0.1245
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: 20ae2b82b18d2c6f783a62cac6ec736fd209f358625b95dd0b35e81cd4c95b18
created: 2018-09-16 21:56        size: 251.1 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: 31c66c3818d4e44c1718cfcf79ee4087ade5a5b1c9c66ea920081b262eb3f56c
created: 2018-09-16 21:56        size: 2.7 MB
sha256sum: f7622370fc1377577a45e7c813bc06eaca51cbcbdd6c755c0b62d61de67abef7
created: 2016-10-01 00:09        size: 2.2 MB
 

Windows package

sha256sum: 40dcad892fe22a50710f6594b05b1e3683e7b5668a2385e059ec55cd81c06f4b
created: 2018-09-16 21:56        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: e13c5dac832e0001eca9a19bdfb5234075570829fa5a4c56a7fe1e1bd99d807f
created: 2018-09-16 21:57        size: 108.2 MB
 

source tarball

sha256sum: e85d6208df54c71871a4ee3353f6ca0df7bd1a7a2bc3b50678db2700b25fda52
created: 2018-09-16 21:57        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.