search

pavelzw / calibre-kindle-comics

A calibre plugin that converts your comics into a readable format for kindle.
ISC License
47 stars 4 forks source link
calibre comics converter epub kindle

readme

Calibre Kindle Comics

GitHub release

Calibre Kindle Comics is a plugin for calibre that converts .cbz and .cbr files into .mobi files that are optimized for Kindle devices.

Issues/new features

If you have problems using this plugin or feature requests, please file an issue. If you can fix an open issue or want to add new features, fork the repository and create a pull request.

Installation

You can find the latest release here.

Before you add the plugin to calibre, you need to add the KindleGen executable to the Kindle Comics Output plugin. Since KindleGen is no longer supported by Amazon, you need to download it from archive.org:

Extract the kindle_comics.zip and place the kindlegen.exe (Windows) or kindlegen (Linux and macOS) into the Kindle Comics Output.zip file.

Then open calibre, go to Preferences > Plugins > Load plugin from file and select Kindle Comics Input.zip and then Kindle Comics Output.zip.

Input Formats

Calibre Kindle Comics can convert .cbz and .cbr files at the moment. It only converts to .mobi, for other conversions like for example .epub, the default calibre output plugins are being used.

How this plugin works

The Kindle Comics Input plugin acts as a converter from .cbz and .cbr to OEB, that's how all Plugins of the type InputFormatPlugin work. The Kindle Comics Output plugin then converts from the OEB format to .mobi by first creating a .epub file and then executing KindleGen. You still can convert from any other format to .epub, Kindle Comics Output will use the default .mobi conversion plugin when the input is not by Kindle Comics Input.

I haven't figured out a way that Kindle Comics Input is only executed when the conversion is to .mobi. That's why there may be strange results when converting to other formats or when viewing the comic file in the calibre ebook viewer. You may want to deactivate the plugin while converting non-comics to other file formats.

Credits

Calibre Kindle Comics is made by Pavel Zwerschke. I used some of the code by Ciro Mattia Gonano and Paweł Jastrzębski from Kindle Comic Converter in the conversion of the comic files.

The plugin uses the image.py class from Alex Yatskov's Mangle with subsequent proDOOMman's and Birua's patches.