ebook-converter/README.rst

This is impudent ripoff of the bits from Calibre project, and is aimed only for converter thing.

My motivation is to have only converter for ebooks run from commandline, without all of those bells and whistles Calibre has, and with cleanest more pythonic approach.

Requirements

To build and run ebook converter, you'll need:

• Python 3.6 or newer

• Liberation fonts

• setuptools

• C compiler (yes, there is a single module, which is written in C)

No Python2 support. Even if Calibre probably still is able to run on Python2, I do not have an intention to support it.

What's supported

To be able to perform some optimization and make converter more reliable and easy to use, first I need to remove some of the features, which are totally not crucial in my opinion, although they might be re-added later, like, for instance there is no automatic language translations depending on the locale settings.

First of all, I'm in the process of getting rid of strongly coupled things to QT libraries, and GUI code as well. Second, I'll try to minimize all modifications from third parties (external modules copied into Calibre project for instance), and make a huge cleanup. I'm not sure if I find time and strength for doing it completely, but I'll try.

Input formats

Currently, I've tested following input formats:

• docx

• epub

• LibreOffice odt

• txt

• Palm pdb

• rtf

• mobi

• fb2

Note, that old Microsoft doc format is not supported, although old documents can be fairly easy converted using text processors programs, lik Word or LibreOffice to supported formats.

Output formats

Currently, following formats are supported:

• lrf (for Sony readers)

• epub

• mobi

• docx

Installation

Ebook converter is somewhere in between in alpha and beta stage, therefore I didn't place it on pypi yet.

Preferred way for installation is to use virtualenv (or any other virtualenv managers), i.e:

$ virtualenv venv
$ . venv/bin/activate
(venv) $ git clone https://github.com/gryf/ebook-converter
(venv) $ cd ebook-converter
(venv) $ # you can either use pip or just setuptools:
(venv) $ pip install .
(venv) $ # OR
(venv) $ python setup.py install

Simple as that. And from now on, you can issue converter:

(venv) $ ebook-converter book.docx book.lrf

License

This work is licensed on GPL3 license, like the original work. See LICENSE file for details.