-
Notifications
You must be signed in to change notification settings - Fork 232
Installation
First install 7z from https://www.7-zip.org/ or with command line:
winget install --id 7zip.7zip
with Homebrew installed
brew install p7zip
brew install unar
Move kindlegen.exe
into the same folder as KCC*.exe
(probably your downloads folder).
It can be found in Kindle Comic Creator at %LOCALAPPDATA%\Amazon\KC2\
The absolute latest version of it is available in Kindle Previewer, but may hang when converting multiple comics in a row as of v3.72 so this version is not recommended. (no problem with version 3.71.1) It is located at %LOCALAPPDATA%\Amazon\Kindle Previewer 3\lib\fc\bin\
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
For flatpak version, please put kindlegen_linux_i386
in ~/.var/app/io.github.ciromattia.kcc/data/kindlegen
You can find the latest binary at the following link:
- https://github.com/ciromattia/kcc/releases
- flatpak : https://flathub.org/apps/details/io.github.ciromattia.kcc
- Docker: https://github.com/ciromattia/kcc/pkgs/container/kcc
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.
see: KindleComicConverter_osx_*.dmg in https://github.com/ciromattia/kcc/releases
If you can't open the last beta, fix it with:
- right click on kcc icon -> click
open
-> clickopen on popup
GitHub Actions does not currently build on Apple Silicon. The provided DMG .app
runs under Rosetta. M1 runners will be available by 2024.
The Apple Silicon compatible fork is available here if you want to run it from source natively:
https://github.com/ciromattia/kcc/pull/523
It only run ~10 seconds faster per volume compared to the packaged version available via Rosetta, since KindleGen still runs under Rosetta.
Or you could also have a look at this other project: https://github.com/celogeek/go-comic-converter
to use kcc-c2e
or kcc-c2p
, use this command
flatpak run --command=kcc-c2e io.github.ciromattia.kcc "$@"
- 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
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
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.)
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
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
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'