Skip to main content

comic_html_view_generator is a command-line tool and library for creating static HTML files for viewing comic books. Given a directory with images or .cbz files in it, it’ll create HTML files which embed those images in order, and an overall “browse all the comics here” HTML page which will list all the comics books which have had a readable HTML file generated from them.

Installation

Install this library via Pip:

pip install comic-html-view-generator

Use with:

python -m comic_html_view_generator --source <SOURCE_PATH> --destination <DESTINATION_PATH>

Assumptions

This tool makes many assumptions about your directory structure. It assumes that in the directory tree provided, that all the images comprising a single “comic book” will be collected into a single folder with all the images in it, with no sub-folders. It’s assumed that each image in an “image folder” is a single “page” of that comic book. Additionally, it further assumes that the alpha-numeric order (00 comes before 01 comes before 0a) of the names of the images in each folder represent the “order” of each page in the comic book.

Usage

Usage of the script is as follows:

$ python -m comic_html_view_generator
usage: comic_html_view_generator.py [-h] [-v] --source SOURCE --destination DESTINATION
                                    [--embed-images] [--maintain-existing-images]

Create HTML files for browsing directories of images as though those directories
represent comic books. Will also automatically expand .cbz files.

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbose         If set, logs additional information to stderr during execution
  --source SOURCE       The source directory of images/cbz files, which will be used as
                        the basis for the all-new directory with images and HTML files
                        for viewing those images.
  --destination DESTINATION
                        The destination directory to be filled with images and HTML
                        files for viewing those images.
  --embed-images        If specified, causes all images to be embedded into the
                        generated HTML files as base64 encoded data URIs. Grows page
                        size, but improves portability.
  --maintain-existing-images
                        If provided, then images (in folders and CBZ files) will only be
                        copied into the 'destination' directory if there isn't already a
                        file with the same name in the destination directory. If an
                        image file would be copied from source to destination, but it
                        exists in destination already, then it is not copied if this
                        argument is provided.

Release files for comic-html-view-generator 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for comic-html-view-generator 0.2.3
File Size Uploaded
comic_html_view_generator-0.2.3.tar.gz 24.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for comic-html-view-generator 0.2.3
File Interpreter ABI Platform
comic_html_view_generator-0.2.3-py3-none-any.whl Python 3 none any Details

Total release size: 51.8 kB

Release files / comic_html_view_generator-0.2.3.tar.gz

Download URL comic_html_view_generator-0.2.3.tar.gz
Size 24.9 kB
Tags Source
SHA-256 checksum
How to use checksums
6e1dbd49b577dff6997b20a50290329482aba76a4a11a75114a775c19c6d627e
BLAKE2b-256 checksum
How to use checksums
4619b3be50f96d7a7a6adffd62e08809d9eccff0afbdf63a0c007269adb7d00b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.8.5

Release files / comic_html_view_generator-0.2.3-py3-none-any.whl

Download URL comic_html_view_generator-0.2.3-py3-none-any.whl
Size 26.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fdf3e4a7ffced06a937f99adea9422ba9ff34ef9329ec92724ca4d8cf49628c4
BLAKE2b-256 checksum
How to use checksums
b097deff1ba7a29173d7456461dd9850c1439a705de4309997a1b1c9dd3e2a25
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.8.5

Release history Release notifications | RSS feed

This release

0.2.3 This release

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page