1
0
mirror of https://github.com/ciromattia/kcc synced 2025-12-12 17:26:23 +00:00
Ciro Mattia Gonano 06675dd68f Ignore IDE files
2012-12-06 11:07:11 +01:00
2012-12-06 11:07:11 +01:00
2012-11-30 13:18:53 +01:00
2012-11-30 14:30:07 +01:00
2012-11-30 18:08:57 +01:00

KindleComicConverter

KindleComicConverter is a MacOS X AppleScript droplet to convert image folders to a comic-type Mobipocket ebook to take advantage of the new Panel View mode on Amazon's Kindle.

REQUIREMENTS

  • Python (included in MacOS and Linux, follow the official documentation to install on Windows)
  • kindlegen in /usr/local/bin/

for standalone comic2ebook.py script:

The app and the standalone comic2ebook.py script can optionally use the Python Imaging Library to correctly set the image resolution on OPF file, please refer to official documentation for installing into your system.

USAGE

Drop a folder or a CBZ/CBR file over the droplet, after a while you'll get a comic-type .mobi to sideload on your Kindle.
The script takes care of calling comic2ebook.py, kindlegen and kindlestrip.py.

WARNING: at the moment the script does not perform image manipulation. Image optimization and resizing (HD Kindles want 758x1024, non-HD ones 600x800) is up to you.

standalone comic2ebook.py usage:

  1. Prepare image folder resizing the images to 758x1024 for HD or 600x800 for non-HD readers, in .png or .jpg formats

  2. Organize the images into the folders (Use leading 0's to avoid file ordering problems). For example,

    Legs Weaver 51/
    Legs Weaver 51/001.png
    Legs Weaver 51/002.png
    etc...

  3. Launch

    python comic2ebook.py <directory> <title>

    The directory should be then filled with a .opf, .ncx, and many .html files.

  4. Run Kindlegen on content.opf. Depending on how many images you have, this may take awhile. Once completed, the .mobi file should be in the directory.

  5. Remove the SRCS record to reduce the .mobi filesize in half. You can use Kindlestrip.

  6. Copy the .mobi file to your Kindle!

CREDITS

This script exists as a cross-platform alternative to KindleComicParser by Dc5e (published in this mobileread forum thread)

The app relies and includes the following scripts/binaries:

Also, you need to have kindlegen v2.7 (with KF8 support) which is downloadable from Amazon website and installed in /usr/local/bin/

CHANGELOG

  • 1.00 - Initial version
  • 1.10 - Added support for CBZ/CBR files in comic2ebook.py
  • 1.11 - Added support for CBZ/CBR files in KindleComicConverter

TODO

  • bundle a script to manipulate images (to get rid of Mangle/E-nki/whatsoever)

calibre2ebook.py

  • Add gracefully exit for CBR if no rarfile.py and no unrar executable are found
  • Improve error reporting

Copyright (c) 2012 Ciro Mattia Gonano. See LICENSE.txt for further details.

Description
No description provided
Readme 66 MiB
Languages
Python 99.6%
Dockerfile 0.3%