Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Earth Reader for Web

Project description

https://raw.github.com/earthreader/web/master/artwork/icon_256x256.png

Earth Reader for Web

Web frontend of Earth Reader.

Distributed under AGPLv3 or later.

Install

You can install Earth Reader for Web using pip:

$ pip install EarthReader-Web

Then you can use command earthreader.

$ earthreader -h

Repository

Repository is a directory to store data. It can be inside of Dropbox or Google Drive folder to be synchronized with other devices. You also can synchronize the repository directory using rsync.

If the path that doesn’t exist yet is passed to --repository option or EARTHREADER_REPOSITORY environment variable the new folder will be automatically created.

Standalone server

You can run Earth Reader for Web using its standalone server:

$ earthreader server /path/to/repository/dir
$ earthreader server -p 8080 /path/to/repository/dir  # listen to 8080 port
$ earthreader server -d /path/to/repository/dir  # debug mode

And then open http://localhost:<port>/ with your browser.

WSGI server

Earth Reader for Web is actually an ordinary WSGI-compliant web application, so you can run it using your preferred WSGI server e.g. Gunicorn, mod_wsgi. The WSGI endpoint is earthreader.web.app:app. Note that you can provide the path of repository by setting EARTHREADER_REPOSITORY environment variable.

For example, you can run it on Gunicorn:

$ export EARTHREADER_REPOSITORY=/path/to/repository/dir
$ gunicorn earthreader.web.app:app

Or you can attach Earth Reader to Apache with mod_wsgi like this:

<VirtualHost *:80>
  ServerName yourwebsite.com
  WSGIDaemonProcess earthreader user=www-data group=www-data threads=1
  WSGIScriptAlias / /var/wsgi/earthreader.wsgi

  <Directory /var/wsgi/>
     WSGIProcessGroup earthreader
     WSGIApplicationGroup %{GLOBAL}

     Order deny,allow
     Allow from all
     # We recommend you to use authorization for security.
     AuthType Basic
     AuthName "Private rss reader"
     AuthUserFile /var/wsgi/earthreader.htpasswd
     Require valid-user
  </Directory>
</VirtualHost>
#!/usr/bin/env python
#/var/wsgi/earthreader.wsgi
import sys
from earthreader.web.app import app as application

application.config.update(
    REPOSITORY='/path/to/repository/dir'
)

And open http://yourwebsite.com/ in your browser.

Crawler

You can manually crawl feeds as well via CLI:

$ earthreader crawl /path/to/repository/dir

Keyboard shortcuts

Vim-inspired keyboard shortcuts are also available:

  • j/k: Older/newer entry.
  • n/p: Next/previous subscription.
  • o: Open entry in new tab.
  • r: Refresh the feed.
  • s: Star/unstar.
  • u or m: Mark as unread.
  • ?: This help message.

Changelog

Version 0.1.0

Released on December 23, 2013. Alpha version.

Release history Release notifications

History Node

0.3.0

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.2

History Node

0.1.1

This version
History Node

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
EarthReader-Web-0.1.0.tar.gz (85.1 kB) Copy SHA256 hash SHA256 Source None Dec 23, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page