https://github.com/eduhoribe/comic-builder
Build e-book files from comic images
https://github.com/eduhoribe/comic-builder
comic comic-builder comics ebook ebook-generator ebooks epub kindle kindle-books kindlegen manga manga-py mobi pip pypi pypi-package python python3
Last synced: 3 months ago
JSON representation
Build e-book files from comic images
- Host: GitHub
- URL: https://github.com/eduhoribe/comic-builder
- Owner: eduhoribe
- License: mit
- Created: 2020-10-28T11:43:44.000Z (over 5 years ago)
- Default Branch: goshujin-sama
- Last Pushed: 2020-11-17T23:24:17.000Z (over 5 years ago)
- Last Synced: 2025-10-30T00:00:02.170Z (8 months ago)
- Topics: comic, comic-builder, comics, ebook, ebook-generator, ebooks, epub, kindle, kindle-books, kindlegen, manga, manga-py, mobi, pip, pypi, pypi-package, python, python3
- Language: Python
- Homepage:
- Size: 77.1 KB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# comic-builder
An auxiliary tool for [manga-py](https://github.com/manga-py/manga-py) to organize, merge and export the files in an
ebook format (EPUB or MOBI)
## Dependencies
- [Python 3.6](https://www.python.org/)
- [KCC](https://github.com/ciromattia/kcc) >> To convert the images in ebook format
### Optional dependencies
- KindleGen >> EPUB to MOBI conversion
* Can be installed running the `kindlegen-installer` command after install the `comic-builder` pip package
* Can also be found in [AUR](https://aur.archlinux.org/packages/kindlegen/)
and [here](https://archive.org/details/kindlegen2.9) for manual installation
## Installation
```
pip install comic-builder
kindlegen-installer # to install KindleGen
```
## Modules
Today there are 4 modules in this repository
- `comic-builder` > Join the comic files into an ebook format
- `kindlegen-installer` > Install the KindleGen binary
- `comic-metadata-inject` > Inject metadata files into the chapters files with the same name
- `comic-metadata-eject` > Extract the chapter's metadata files
P.S. The commands `comic-metadata-inject` and `comic-metadata-eject` can be used together to edit some details in the
chapters metadata
## Suggested Workflow
For sites that support chapter and comic metadata (Ex. MangaDex)
```
manga-py --save-chapter-info --save-manga-info [-d|--destination] "COMIC_DOWNLOAD_PATH" [other-options...] URL
comic-builder [other-options...] "COMIC_DOWNLOAD_PATH/COMIC_NAME"
```
For other sites
* Create a metadata file based
in [this file](https://github.com/eduhoribe/comic-builder/blob/goshujin-sama/samples/comic-metadata-sample.json)
```
manga-py [-d|--destination] "COMIC_DOWNLOAD_PATH" [other-options...] URL
comic-builder --metadata "METADATA_FILE" [other-options...] "COMIC_DOWNLOAD_PATH/COMIC_NAME"
```