Skip to content

Installation

Jump to bottom Edit New page
Alex Xu edited this page Aug 6, 2023 · 55 revisions

7-Zip

Windows

First install 7z from https://www.7-zip.org/ or with command line:

winget install --id 7zip.7zip

Then add 7z to PATH via

setx path "%path%;C:\Program Files\7-Zip"

Be sure to close and re-open KCC so it sees the updated PATH.

Mac

with Homebrew installed

brew install p7zip
brew install unar

Kindlegen

Windows

Move kindlegen.exe from Kindle Previewer into the same folder as KCC.

It can be found in Kindle Previewer Amazon Kindle Previewer 3 Folder\lib\fc\bin, the usual location in windows is in windows is C:\Users\user\AppData\Local\Amazon\Kindle Previewer 3\lib\fc\bin\

There have been some reports that the latest bundled version of kindlegen sometimes hangs, if that happens download an older release.

Mac

Install Kindle Previewer for the latest version of KindleGen.

An older version is available in Kindle Comic Creator

Alternatively, with Homebrew installed,

brew install --cask kindle-comic-creator

DOWNLOADS

You can find the latest binary at the following link:

Windows installation

If you are using Windows 11 and it says "Search application in store?" when you open the .exe file, try using Windows 8 compatibility mode.

MacOS installation

x86_64 version

see: KindleComicConverter_osx_*.dmg in https://github.com/ciromattia/kcc/releases
If you can't open the last beta and the OS says it's damaged, fix it with:

  • right click on kcc icon -> click open -> click open on popup
  • or use spctl --master-disable. To re-enable it you just change it to this: sudo spctl --master-enable

to disable the quarantine popup:

xattr -d com.apple.quarantine /Applications/Kindle\ Comic\ Converter.app
xattr -d com.apple.quarantine -- /Applications/Kindle\ Comic\ Converter.app/Contents/Resources/7z
M1/M2 arm64 version

Building is not available in github on M1 arch.
See this building method, to build it locally: How to build M1

Or you could also have a look at this other project: https://github.com/celogeek/go-comic-converter

FLATPAK

to use kcc-c2e or kcc-c2p, use this command

flatpak run --command=kcc-c2e io.github.ciromattia.kcc "$@"

APPIMAGE

  • install 7zip 
    $ sudo apt-get install -y p7zip-full
  • copy kindlegen into '/usr/local/bin' and grant execute permissions for MOBI conversion. 
    $ sudo cp -R kindlegen /usr/local/bin && sudo chmod a+x /usr/local/bin/kindlegen
  • make appImage executable 
    $ chmod a+x kindleComicConverter-latest-x86_64.AppImage
  • run with backend x11 or it might not work with fedora 
    $ GDK_BACKEND=x11 ./kindleComicConverter-latest-x86_64.AppImage

DOCKER

install kindlegen in your working directory and get last docker image

$ docker pull ghcr.io/ciromattia/kcc:latest

execute kcc-c2e

$ docker run --rm -v "$(pwd):/app" ghcr.io/ciromattia/kcc:latest

example

$ docker run --rm -v "$(pwd):/app" ghcr.io/ciromattia/kcc:latest -p KPW5 ./1.cbz

execute kcc-c2p

$ docker run --entrypoint /opt/kcc/kcc-c2p.py --rm -v "$(pwd):/app" ghcr.io/ciromattia/kcc:latest

INSTALL FROM SOURCE

Easiest to use GitHub Desktop to clone the KCC repo. From GitHub Desktop, open a Command Prompt (Windows)/Terminal (Mac) window in the repo.

Depending on your system Python may be called either python or python3.

We recommend using virtual environments to manage dependencies. (Optional: A code editor like VS Code will automatically re-activate virtual environments.)

Windows

One time setup and running for the first time:

python -m venv venv
venv\Scripts\activate.bat
pip install -r requirements.txt
python kcc.py

Every time you close Command Prompt, you will need to re-activate the virtual environment and re-run:

venv\Scripts\activate.bat
python kcc.py

Mac

You may have issues running the version on master on some Macs. If that happens, run this version instead: https://github.com/ciromattia/kcc/pull/523

One time setup and running for the first time:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python kcc.py

Every time you close Terminal, you will need to reactivate the virtual environment and re-run:

source venv/bin/activate
python kcc.py

Linux

Originally posted by @hhtien1408 in https://github.com/ciromattia/kcc/issues/438#issuecomment-1281159452

$ git clone https://github.com/ciromattia/kcc.git

On Debian based distributions these two commands should install all needed dependencies:

$ sudo apt-get install python3 python3-dev python3-pip libpng-dev libjpeg-dev p7zip-full python3-pyqt5

Then install the necessary packages. You can do it by running the following command. The requirements.txt file is inside this repository, you will see it when you clone the repo.

$ pip3 install -r 'requirements.txt'

This should install the required packages. You can check the version by running

$ pip3 freeze

If the packages are in the wrong version, you can try to upgrade them by running

$ pip3 install --upgrade name_of_the_package

Download kindlegen.

$ wget https://archive.org/download/kindlegen_linux_2_6_i386_v2_9/kindlegen_linux_2.6_i386_v2_9.tar.gz | tar xvzf kindlegen

Copy kindlegen into '/usr/local/bin' and grant execute permissions for MOBI conversion.

$ sudo cp -R '/home/user/Desktop/kindlegen' '/usr/local/bin'

$ sudo chmod +rwx '/usr/local/bin/kindlegen'

Run python file for KCC GUI

$ python3 kcc.py

If everything goes well, you now should be able to use it.

Create destop file in '~/.local/share/applications' with codes:

#!/usr/bin/env xdg-open

[Desktop Entry]
Type=Application
Name=Kindle Comic Converter
Icon=kcc
Exec=python3 '/home/user/kcc/kcc.py'
Terminal=false
StartupWMClass=kcc
Name[en_US]=Kindle Comic Converter

Copy icon file into '/home/user/.local/share/icons'

$ sudo cp -R 'icons/comic2ebook.png' '/home/user/.local/share/icons'
Add a custom footer
Add a custom sidebar
Clone this wiki locally