Skip to content
This repository has been archived by the owner. It is now read-only.
exlibris is a tool for adding an ex libris to EPUB eBooks, available as a CLI tool, a GUI tool, and Calibre plugin.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cli
ex_libris_examples
gui
lib
plugin_calibre
LICENSE
README.md

README.md

exlibris

exlibris is a tool for adding an ex libris to EPUB eBooks, available as a CLI tool, a GUI tool, and Calibre plugin.

  • Version: 1.0.19
  • Date: 2014-09-02
  • Developer: Alberto Pettarin (contact)
  • License: the GNU General Public License Version 3 (GPLv3), see LICENSE

There are three main usage cases:

  1. a CLI script, useful for batch processing;
  2. a GUI tool, useful if you prefer a graphical interface; and
  3. a plugin for Calibre.

Important updates

  • 2014-09-02 Please note that exlibris needs substantial code refactoring. Unfortunately, I no longer have time to develop or maintain exlibris. Please fork and improve. If you are willing to take it over, please let me know.

Main library

Look inside the lib/ directory.

CLI

Look inside the cli/ directory.

To get its usage, run it without arguments:

$ python exlibris-cli.py

GUI

Look inside the gui/ directory.

To run it:

$ python exlibris-gui.py

To get the Italian version:

$ python exlibris-gui.py it

Plugin for Calibre

Look inside the plugin_calibre/ directory.

To compile it locally:

$ bash compile_plugin.sh

Note that you can get this plugin directly using the Plugin manager inside Calibre.

License

exlibris is released under the GNU General Public License Version 3 (GPLv3).

Limitations and Missing Features

  • Perform real EPUB parsing using an XML parser
  • Code clean-up: remove replicated code
  • Let the user insert an image as the ex libris (e.g., by building a suitable XHTML page around it)
  • Better command line parsing (e.g., by using argparse)
  • (Plugin Calibre only) Expose shortcut to the Calibre shortcut manager
  • (Plugin Calibre only) When using the "Copy EPUB" function, mark the new EPUB (with the ex libris) to distinguish it from the original one

Analytics

You can’t perform that action at this time.