Skip to main content

Jelly's Manga Reading Thingy.

This is my own rendition of the excellent Mokuro project, made mostly just to do it. That being said, if you have any suggestions, please give me a heads-up and I will be happy to implement it. Probably.

Installation

To install, you should only need to run:

pip install comic-ocr-reader

Once that it is installed (it may take some time, there are large dependencies in there) you should then run:

comic-ocr-reader

Or if that doesn't work:

python3 -m comic-ocr-reader

Usage

  1. Prepare a folder containing the images you would like to process. As of v.0.0.1 the images in this folder must be named the page number you would like that image to be. (e.g. the PNG image you would like to use as the second page should be titled "2.png") The name of the folder will be the name of the resultant HTML file. (e.g. if your folder is titled "Naruto" the output HTML file will be "Naruto.html" )
  2. Run comic-reader-ocr and enter the "folder" command.
  3. Enter the absolute path of the folder from step 1 and wait for comic-reader-ocr to process all the images.
  4. Once finished, the resulting HTML file will be placed within the folder from step 1.
  5. Open the resulting HTML using your web browser of choice.

Notes

  • You will need to keep the HTML file within the same folder as all the rest of the pages. Otherwise, the images will not load.
  • Depending on your hardware, it may take quite some time to fully process all pages. On my laptop, it took roughly ~8s/page. I imagine on something with an actual GPU it would be faster though.

FAQs (as decided by Myself)

  1. Is this a worse version of various other projects (e.g. Mokuro)?

    • Yes.
  2. Do you know how to like. Write things. That work?

    • No.
  3. Why did you do this?

    • As a learning exercise, mostly. Plus, I like trying to reinvent wheels.
  4. Can I make suggestions?

    • Yes.
  5. Did you use AI for this?

    • Yes. Most of the HTML and JS was AI generated, as unfortunately I really really don't like looking at either of those things.
  6. Are you going to try to make this a webapp because that probably makes a lot of sense or just. Like. Something that isn't Python so that it's easier to distribute or something?

    • Yes. I'll probably try to rewrite this in Rust or do something like the mokuro-reader project.

Metadata

Release files for comic-ocr-reader 0.0.5

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-ocr-reader 0.0.5
File Size Uploaded
comic_ocr_reader-0.0.5.tar.gz 13.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for comic-ocr-reader 0.0.5
File Interpreter ABI Platform
comic_ocr_reader-0.0.5-py3-none-any.whl Python 3 none any Details

Total release size: 26.4 kB

Release files / comic_ocr_reader-0.0.5.tar.gz

Download URL comic_ocr_reader-0.0.5.tar.gz
Size 13.6 kB
Tags Source
SHA-256 checksum
How to use checksums
036fe29de34ae7474059eff769d8f5f96099702ff99f264015d61e0d37353f97
BLAKE2b-256 checksum
How to use checksums
fe8f404039236ccf46e381582d1876c29323a9d40fa9c58d22d459f23b69e484
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 30, 2026.

Transparency log

Release files / comic_ocr_reader-0.0.5-py3-none-any.whl

Download URL comic_ocr_reader-0.0.5-py3-none-any.whl
Size 12.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
21dba2a2184d47b10d6c7f10a4c9e8d5ae56cfd30b9a9b63de35c341d42377b8
BLAKE2b-256 checksum
How to use checksums
2e3f88985b3a75be4876d837e85c01601b37e77632ffc93533ff5b0d7a3c3ffa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 30, 2026.

Transparency log

Release history Release notifications | RSS feed

1.0.3

2 release files

This release

0.0.5 This release

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

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