Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kevinhendricks/KindleUnpack

python based software to unpack Amazon / Kindlegen generated ebooks
https://github.com/kevinhendricks/KindleUnpack

Last synced: 1 day ago
JSON representation

python based software to unpack Amazon / Kindlegen generated ebooks

Awesome Lists containing this project

README 

        
KindleUnpack

============



python based software to unpack Amazon / Kindlegen generated ebooks



KindleUnpack unpacks a non-DRM Kindle/MobiPocket ebook into its component parts 

which change depending on the type of Kindle/Mobi ebook being processed



	- MobiPocket and early Kindle version 7 or less ebooks are unpacked to the 

            original html 3.2 and images folder that can then be edited and reprocessed by 

            MobiPocketCreator.



	- Kindle Print Replica ebook are unpacked to the original PDF and any associated images.



	- Kindle KF8 only ebooks (.azw3) are unpacked into an epub-like structure that may or 

            may not be a fully valid epub depending on if a fully valid epub was 

            originally provided to kindlegen as input.  NOTE: The generated epub should be

            validated using an epub validator and should changes be needed, it should load

            properly into Sigil and Calibre either of which can be used to edit the result

            to create a fully valid epub.



	- Newer Kindle ebooks which have both KF8 and older versions inside are unpacked into 

            two different parts: the first being the older MobiPocket format ebook parts 

            and the second being an epub-like structure that can be edited using Sigil



The KindleUnpack program requires Python 2.7.X or Python 3.4 or later to function properly. 



On Windows machines we strongly recommend you install the free version of ActiveState's 

Active Python 2.7.X or 3.4.X or later as it properly installs all of the required parts 

including the tk widget kit and updates the system path on Windows machines.  The official 

installer from python.org sometimes does not properly handle this for Windows machines.



On Mac OS X 10.6.X and later and almost all recent Linux versions, the required version 

of Python is already installed as part of the official OS installation so Mac OS X and 

Linux users need install nothing extra.



To install KindleUnpack, simply find a nice location on your machine and fully unzip it.  

Do not move the KindleUnpack.pyw program away from its associated "lib" folder.  If you 

have a proper Python 2.7 or later installation on your machine, you should be able to 

simply double-click the KindleUnpack.pyw icon and the gui interface should start



If you would prefer a command-line interface, simply look inside KindleUnpack's "lib" 

folder for the KindleUnpack.py python program and its support modules.  You should 

then be able to run KindleUnpack.py by the following command:



```sh

python kindleunpack.py [-r -s -d -h -i] [-p APNX_FILE] INPUT_FILE OUTPUT_FOLDER

```



where you replace:



`INPUT_FILE`      - path to the desired Kindle/MobiPocket ebook



`OUTPUT_FOLDER`   - path to folder where the ebook will be unpacked



### Options



`-h`               print this help message



`-i`               use HDImages to overwrite lower resolution versions, if present



`-s`               split combination mobis into older mobi and mobi KF8 ebooks



`-p APNX_FILE`     path to a .apnx file that contains real page numbers associated

                   with an azw3 ebook (optional).  Note: many apnx files have

                   arbitrarily assigned page offsets that will confuse KindleUnpack

                   if used



`--epub_version=`  specify EPUB version to unpack to: 2, 3 or A (for automatic) or

                   F for Force to EPUB2, default is 2



`-r`               write raw data to the output folder



`-d`               dump headers and other debug info to output and extra files



Please report any bugs or comments/requests our sticky forum on the Mobileread website.  

It can be found at http://www.mobileread.com/forums.  



Look under E-Book Formats > Kindle Formats > KindleUnpack (MobiUnpack).



License Information



KindleUnpack

    Based on initial mobipocket version Copyright © 2009 Charles M. Hannum 

    Extensive Extensions and Improvements Copyright © 2009-2014 

         By P. Durrant, K. Hendricks, S. Siebert, fandrieu, DiapDealer, nickredding, tkeo.

    This program is free software: you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation, version 3.