Don’t I need to Install a Software?
What is the Java Script Code?
It is correct that you don’t need to install a software.
The Java script code means all the lines that are in the file simulator.js, which you can access by clicking on it and then copy the whole thing by using this icon:
1 Like
It worked. Thank you.
3 Likes
Good job! Enjoy the reading 
1 Like
If you have Tampermonkey or a similar extension installed, you can now install this as a UserScript:
4 Likes
nice… if only this was there yesterday 
just finished mokuroing 16 vols
do appreciate the timing is adjustable…
always set it at 3 sec…cuz figure what’s the rush…
saving everything takes longer than running mokuro anyway
thank you gpu!!!
[REMOVE IF NOT ALLOWED !]
With a lot of help from AI, I’ve created a koreader plugin to read japanese manga which have been OCR’ed with Mokuro directly within Koreader.
While the combo Mokuro Reader + Yomitan is great, I don’t like reading on my computer, and using it offline isn’t always easy.
The Mokuro-reader Koreader plugin lets you read .cbz files containing your manga images in jpg format and the .mokuro file created when you use Mokuro directly in Koreader. When you tap on a speech bubble, the text will show in a popup, and you can then select manually to look up words in the dictionary. Simply tapping a word won’t work, because the popup doesn’t quite behave like a book, but selecting by holding and dragging your finger is quite precise. You can adjust the font size in the popup to make it easier
The online Mokuro Reader can read .zip files, but also .cbz, so you don’t have to create many files. Just compress together your folder with manga images and the .mokuro file, rename to .cbz, and you’re done.
What you can’t really do is effectively sentence mine, as sentence recognition before and after the word doesn’t seem to work in the plugin, and selecting the panel image for sending to your flashcards isn’t supported. This is mainly for reading manga and looking up whatever word you need.
Here is the link to the repo ! (tested on Kobo, Pocketbook, Boox; I don’t have a jailbroken kindle to test at the moment, but I suppose it should work too)
4 Likes
My jumbled and random thoughts on KOReader + this Mokuro plugin:
KOReader
- KOReader makes it very easy to change the page accidentally.
- Turning off “tap to turn page” resolves this.
- KOReader seems to lack pinch zoom, unless I’m missing something.
- KOReader’s panel zoom is interesting.
- Pinch zoom does work here where it’s less necessary.
- Swipe down exits the panel zoom in one action.
- Kobo shows a bunch of random KOReader files as imported files. I wonder if there’s a way to “hide” those from Kobo.
- This is the primary reason I never installed KOReader on my current device. But the panel zoom might get me to consider using KOReader.
@Magyarapointe’s plugin:
- I recommend mentioning in the readme that KOReader v2025.08 or higher is required.
- This is the release that introduced “lib/ffi/archiver.so”, which is necessary to use the plugin. (I started with v2025.04, which would crash when loading the plugin, then jumped to v2025.10, which runs just fine.)
- Might be worth making the plugin work with “panel zoom” if possible. Maybe that’s not doable, as this seems to be an “image viewer” mode.
- On the manga I’m reading with, the hit box to bring up the OCR’d text is a little low, so tapping the top section of text doesn’t work, tapping lower on the text does, and tapping a little below the text works to bring up the OCR text.
- I didn’t test this on more than one manga.
- Dictionary lookups this way are a ton faster than my alternate method:
- Tap on menu icon.
- Select dictionary.
- Key in word and hope I don’t forget it.
- Japanese definition comes up.
- Tap to switch to Japanese-to-English dictionary which cannot be set as a default.
Will I use this plugin? I don’t know yet. But if I do, it’ll make it a lot easier for me to get through no-furigana manga by allowing me to easily read it on the bus.
3 Likes
it’s pretty neato… but my kindle isn’t jail broken and i only side load epubs…
at some point would be nice to have manga with yomitan… w/o lots of complicated setup procedures
1 Like
Thank you for your comments !
I have released V2.0.0, and updated the README So far, I haven’t been able to really get it to work well in Panel Zoom (it’s hit-or-miss ; I’ll try to get it to work more reliably) but…
I’ve made it compatible with the double-page spread mode from this plugin.
and…
Sentence mining works ! both with Koreader’s built-in vocabulary builder and the Anki Koreader plugin !
(no image selection though, but I don’t think Koreader can actually do that !)
It might have to do with the zoom mode. The best fit I’ve found is with page mode (vs continuous), zoom to content, and fit to full or height (not width). All of which are found in the bottom menu of Koreader.
1 Like
I’ll try playing with that. I did adjust various settings when I first tried the reader, and that’s one thing I had changed.
1 Like
I now have also a panel zoom - enabled version, with sentence mining, in both portrait and landscape with double page spread version. HOWEVER : the tap zones are not always precise, especially with very busy pages (think One Piece). I’m not sure if there’s anything else I can do to fix it, as the plugin uses the speech bubble coordinates from the .mokuro files, and it seems that’s where the issue lies. In this release, in panel zoom mode, the tap zones are indicated so you won’t waste time tapping around to figure out what will work and what won’t. Still, it works better in non-panel zoom mode.
This new release is alongside the one from yesterday night, so you can choose which one suits you best.
2 Likes
If I were to look for only one more feature, it would be to have the Mokuro text pop-up (which closes before the dictionary window opens) re-open after closing the dictionary.
Of the manga volumes I plan to finish reading by the end of the year, I have four with furigana and six without (plus Shadows House, which is in color so I won’t read it on an e-ink device).
During my commute and lunch break reading sessions on my Kobo e-ink device, I’ll undoubtedly run out of furigana material in the next week. Having an easy way to do lookups on manga without furigana is going to really help me out.
1 Like
Ask, and you shall receive !
(within reason…)
The newest version has a persistent popup, so you can do multiple lookups within the same speech bubble without having to reopen it. When you’re done, just tap the main page, and the popup will go away.
I also updated the panel zoom version with this feature, but it’s still buggy, and it seems to behave very differently from manga to manga, so I don’t know if there is an easy way to fix that.
1 Like
Does anyone know why Mokuro sometimes picks the second page as the cover and not the first? My pages aren’t numbered like 0001-0200, but the cover does come first in sorting in the folder. But sometimes I get the second or third page displayed as the cover and it drives me crazy. I tried renaming the files and deleting the .html and .mokuro files to just generate those parts (and not the OCR) but it’s still coming up as the second page as the cover. I know this is super small but it drives me nuts 
1 Like
woo hoo good to know my evil plan has been working all along 
Wouldn’t have had to resort to such trickery if only someone had believed writing practice wasn’t filthy lies 
seriously though never had a problem and I’ve run hundreds of them through mokuro… I’m going to guess it has to do with the actual file naming themselves…
I use power rename (windows) if anything is wonky and make sure they are all 2 or 3 digit numbers and all are the same file name and type …
mangaA-00.jpg
mangaA-01.jpg
mangaA-02.jpg
works fine… if you have more than 100 pages then be sure to keep 3 or 4 places for the numbers - for example this would be a possible issue
mangaB-1.jpg
mangaB-10.jpg
mangaB-11.jpg
mangaB-12.jpg
mangaB-2.jpg
mangaB-3.jpg…
another possible thing to watch out for is the japanese numbering vs the english numbering that could be confusing things… they look the same but in ascii they are not…
０ 0 are not actually the same ascii char … so if files are named ０1 and some are named 02 03 04…
not sure if you have checked all this if so no idea what else it could be but the only time I’ve had a problem is when I have goofed up the last few digits of the file…when in doubt keep 3 or 4 numbers so the leading zeros aren’t dropped when you have more than 10 or 100 pages
also I usually keep my cover page with a 00 or 000 numbering so it always sorts first…
hope it helps… good luck!!!
1 Like
What are the file names of the cover and a random content page?
1 Like
Holy heck was this an adventure. After 4.5 hours, I finally managed to get a volume uploaded into the web reader and it works 
Idk if it works with anything newer than 3.9.13. I can tell you that Python 3.14 it 100% does not work. And that if you want the ‘add to path’ to show up you CANNOT do it through the python installer they try and foist onto you.
It also took me half an hour to realize that I had to upload the .mokuro and the original .jpg folder at the same time for it to actually upload into the web reader. (I blame the 4 hours prior frustrating the heck out of me and not rereading the mokuro readme.. considering its literally the 3rd bullet haha)
Like 3.5 hours was spent just troubleshooting my Python and why on earth it wasn’t working. The good news is that 99% of the information I needed was found in this forum somewhere. I just searched it till i found what i needed, or it was in the github readme.
Thank you for this! Its going to be so nice to be able to read at my desk while I’m learning instead of juggling a physical book and going between screen and book.
6 Likes
With great power comes great responsibilities, but you have passed the test, you are now worthy of Mokuro’ing all the things! Have fun!
4 Likes
I plan on it! Everyone being so helpful over the past couple of years is the only reason my first post was a ‘woo it worked!’ and not a ‘what on earth am I missing here.’ 
4 Likes