Mokuro: Read Japanese manga with selectable text inside a browser

I’ve seen others comment on this as well.

I read zoomed in and use the mouse to zoom in/out, pan, and do look-ups, so I don’t use the keyboard for navigation myself.

Although I don’t recall when it happens, I often end up with the image 90% off-screen. Not in my normal reading, though, so I can’t recall what condition it occurs in.

1 Like

Thanks for sharing the bookshelf code, it’s really neat! I love the ‘progress colour effect’ :heart_eyes:

1 Like

I’ve been playing around with adding novels to your bookshelf :grin:

I buy them from Amazon, then load them up in Calibre and extract the text.

The green line is a bookmark. It helps me keep my place (as you’d expect lol) and it tracks the current ‘page’ for the progress bar.

The code is probably pretty gnarly cause there was a lot of trial and error involved, but I look forward to polishing it as I learn about coding more properly :grin:


I tried GitHub - ChristopherFritz/BookWalker-Screenshot-Simulator on a book I’ve purchased but it didn’t work (no error, just prints Downloading complete! but didn’t do anything).
Is it possible that it only works on the free previews?

It works for me! Did you make sure that “Page Moving Direction” was set to “Vertical” before running it?


Aah!! Indeed it wasn’t on Vertical, I hadn’t checked and just assumed it still was from using it that way last time. Thanks a lot :smiley:


How far did you get? I got it running with Docker. It doesn’t like it when I feed an entire novel into it though :stuck_out_tongue_closed_eyes:


It’s been a while since my last couple of attempts, so I don’t recall.

I’ve never used Docker, so maybe that’s a route for me to try out one day.

For what it’s worth, I used the instructions here.

1 Like

I think running a simple webserver locally allows localstorage to work across pages. May not be the best fit for everyone, but if you have python you can run:

python3 -m http.server --bind localhost

to serve the files in the current directory at http://localhost:8000/.


This worked for me. That means how I work with manga text is about to be revolutionized.

Consider the word 「走り去る」.

Juman++ breaks this down as:

  • 走る (verb)
  • 去る (verb)

That means my frequency list sees this as two separate words to learn and two words (per instance) on the total word count for the work.

Ichiran breaks this down as:

  • 走り去る (verb)

Using this for my frequency list, it would be seen as one word and one words (per instance) on the total word count.

I still need to test how Ichiran handles expressions and work out how I want to utilize it in that case.


Input: 「噂をすれば影」


  • する


  • 噂をすれば影

Input: 「噂をすれば」


  • する


  • する

Love that feeling \o/
Have fun!


Hello, thank you so much for this!

I followed the instructions, but I’ve been stuck for a long time. When I ran the mokuro command in the terminal, I received the following output:

I have also tried changing the path in advanced system settings (ChatGPT told me to do that lol), but the output is the same even then.

Sorry if this is a very basic question, I have absolutely zero technical knowledge. I’m just hoping I can magically start using Yomichan before the ロジカとラッカセイ book club starts :smiling_face_with_tear:

1 Like

This is the expected result (don’t take advice from chatgpt please). You now need a folder full of the images from a manga and run mokuro as

mokuro path/to/yourFolderName

Then I guess I need to figure out how to get past the DRM to download the images TT

Another very silly question: Once I download (which…I don’t think is gonna happen anytime soon), I can only use mokuro through the folder right? and not on the official website (BW)?

1 Like

Yes, gives you an html file, which is basically like a local website on your harddrive. You need to open that up, and the mokuro result will be used in that.


Makes sense, thank you!

If you purchased from BookWalker, one method is to screenshot each page manually. (Or automate it.)


Thank you so much!! (sorry just realized that you’ve already mentioned it in the thread)

After downloading, I ran mokuro as mokuro path/to/BBC (BBC is the name of the folder), and it says:

AssertionError: C:\Users\THIS PC\path\to\BBC must be a directory

What do I do?

1 Like

Try this syntax instead:

mokuro "C:\Users\Akashelia\Japanese\Mokuto\Ruri\01"

It should be your path of course, the one you can see in your file explorer