Overview

didjvu uses the Gamera framework to separate foreground/background layers, which can be then encoded into a DjVu file.

Prerequisites

The following software is required:

• Python 3 (≥ 3.6)
• Gamera-4 (≥ 4.0) (not available on PyPI)
• Pillow
• DjVuLibre (≥ 3.5.22)
• minidjvu (≥ 0.8) for the --pages-per-dict/-p option

Additionally, one of the following libraries is needed for the --xmp option:

• GExiv2 (≥ 0.12.2) + PyGI or
• python-xmp-toolkit or
• py3exiv2

Installation

The easiest way to install didjvu is from PyPI:

pip install didjvu

Alternatively, you can use didjvu without installing it, straight out of an unpacked source tarball or a VCS checkout.

It's also possible to install it from source for the current interpreter with:

pip install .

The man pages can be deployed using:

make install_manpage

By default, make install_manpage installs them to /usr/local/. You can specify a different installation prefix by setting the PREFIX variable, e.g.:

make install PREFIX="$HOME/.local"

About this fork

This repository is a port of the original repository to Python 3.

The process involved the 2to3 tool and manual fixes afterwards to get the existing tests to pass. Some of the error reports and fixes arising from the early porting process have been contributed by @rmast.

At the moment there are no plans to submit a pull request to the upstream repository, which would probably require some changes to my code as well. This is mostly due to the corresponding upstream issue being marked as wontfix: Issue #13.

I will try to keep this fork/port in sync with the upstream changes where necessary. Please note that I do not have any plans on implementing completely new features for now. Feature requests and bugs which can be reproduced in the original version as well should be reported at both places in the best case.

Differences from upstream

• Package requires Python ≥ 3.6.
• Drop old Gamera workarounds.
• Migrate from nose to plain unittest stdlib module.
• Conform to PEP8 coding style.
• Use standardized setup.py-based installation.
• Rename lib to didjvu and migrate didjvu binary to __main__.py and console script version.