This guide is assumes you already have your base mining workflow setup and only contains instructions on how to mine manga.
If you're brand new to learning Japanese I recommend you check out The Moe Way guide and the Lazy guide.
To process manga we use mokuro, a tool that processes your manga with manga-ocr to extract all of the text, then generates a manga viewer as an html file that you can open.
This guide relies on a fork of mokuro that adds various improvements and new features to the manga viewer.
The repos contain detailed usage instructions, but in short:
pip install git+https://github.com/ZXY101/mokuro.git@master
If you wish to use the default mokuro, you can install it with:
pip3 install mokuro
mokuro "/path/to/manga/volume 1"
This will generate the html file for the one volume of manga, if you wish
to process multiple volumes you can pass in multiple paths or you can
specify the parent directory:
mokuro --parent_dir manga_title/
Using ZXY101's fork, it will also generate
files that are optimised for viewing on mobile devices, the fork also
disables asking for confirmation by default.
mokuro --parent_dir manga_title/ --mobile False
If you would like to use the fork but already have a ton of processed
manga, you can use
this python script
to quickly reprocess your manga. If you still have your
_ocr folders then you can simply rerun mokuro with the fork
to update your html files.
python generate_ocr_files.py "manga_title/" --run_mokuro
The above command will generate the ocr files for all the html files in
the directory specified then rerun mokuro on the directory.
PS. You need to have Beautiful Soup installed if you dont already, pip install beautifulsoup4.
ZXY101's mokuro fork adds anki connect integration, assuming you have your yomichan workflow setup correctly - you can now configure mokuro to be able to quickly create new cards.
The fork adds the ability to instantly add the selected sentence and image to your last created card.
To configure anki connect, open the advanced settings from the dropdown menu and tick Enable anki connect integration?
Due to secuirity concerns, browsers set various limitations on local files. Unfortunately this means that you cannot use the anki connect integration if you open your html files directly.
Add the server domain to the webCorsOriginList.
Note: You can access mokuro.moe from both www.mokuro.moe and mokuro.moe so be sure to add both to the list . Also I add both localhost:8000 and localhost:8080 because I have servers on both ports, but you only need to specify whatever port you're using.
If it's still not working after adding your server to the list you can try temporarily adding "*" to the list, if that works then you may have entered your server incorrectly.
The last thing you need to do is enable anki connect integration in the advanced settings then specify your sentence and picture fields.
If you've already configured your anki settings to grab sentences, you may still want to use sentence grabbing since it will grab the entire dialog block without any parsing issues. It will also do it's best to preserve any existing html you may have in your sentence. If you would prefer it to not touch the sentence at all, simply disable sentence grabbing
Once you've configured all of your settings, click the Export settings button and store the settings.json file somewhere. Whenever you start a new manga/volume you can now import your settings and not need to worry about reconfiguring everything.
There are advantages and disadvantages to both methods, choose whicher suites your preference.
Jidoujisho is an incredible android app that contains a suite of tools to help you immerse on mobile. It incorporates it's own popup dictionary where you can load up and configure your existing yomichan disctionaries. Once fully configured the experience is almost on par with a full yomichan/pc workflow, Jidoujisho makes adding cards on mobile very easiy with auto audio/sentence/picture grabbing and generation.
Jidoujisho has a reader specifically designed for mokuro files that adds the ability to navigate using the volume keys. For the best experience, use the mokuro fork to generate .mobile.html files and open them up in Jidoujisho. The mobile files adds easier to access navigation buttons as well as the ability to navigate with swipe gestures.
To add manga to Jidoujisho, you can either load up local files or read them directly from a server.
Kiwi browser is a chromium based browser that supports extensions. This means you can install and configure yomichan to be exactly the same as your PC workflow.
Using Kiwi browser requires more config but allows you to use any custom handlebars you may have setup as well as use other incredible tools such as Local Audio Server for Yomichan
To be able to add cards to your anki collection within kiwi browser, you will need to use Anki Connect AndroidHow to mine manga with kiwi browser and ZXY101's mokuro fork:
Unfortunately when it comes to IOS you don't have as many options.
You can setup a simple web server to access your processed manga and then use 10ten Japanese Reader for easy lookups.
You won't be able to use anki connect to create your anki cards so you should make sure anki connect integration is disabled in the advanced settings to avoid any errors.
Processing manga with mokuro requires a decent PC and can take quite a bit of time.
If you have neither the time nor the resources to process manga yourself - you can find a small collection of already processed manga at:
If you would like to contribute to the collection or make a manga request, see the README inside of the Upload folder.NOTE: The stability of the site cannot be guaranteed and may occasionally go down, I recommend downloading anything you don't want to lose.
The manga is shared using hfs, when you download from the site it will automatically zip the files - this can cause issues with unicode file paths.
If the manga you're downloading contains Japanese characters, it will likely garble the file names and the html file will no longer be able to find the images.
To fix this, you can rename the folders to their original names - be sure to copy and past to get the exact characters.
This issue will be resolved in a future version of hfs.