Table Of Contents

Next topic

libearth — The shared common library for Earth Reader apps

This Page


Libearth is the shared common library for various Earth Reader apps. Earth Reader try to support many platforms as possible (e.g. web, mobile apps, desktop apps), so there must be a large part of common concepts and implementations they share like subscription lists, synchronization through cloud storages between several devices, and crawler, that libearth actually implements.

Compatibility & portability

Libearth officially supports the following Python implementations:

  • Python 2.6, 2.7, 3.2, 3.3, 3.4
  • CPython, PyPy, IronPython

For environments setuptools not available, it has no required dependencies.

See also tox.ini file and CI builds.


You can install it using pip:

$ pip install libearth

See PyPI as well.

Open source

Libearth is an open source software written by Hong Minhee and the Earth Reader team. See also the complete list of contributors as well. Libearth is free software licensed under the terms of the GNU General Public License Version 2 or any later version, and you can find the code at GitHub repository:

$ git clone git://

If you find any bugs, please report them to our issue tracker. Pull requests are always welcome!

We discuss about libearth’s development on IRC. Come #earthreader channel on Ozinger network. (We will make one on freenode as well soon!)

Build Status Coverage Status
Fork me on GitHub