manga-wordlist-extractor 0.1.1

A utility to extract vocabulary lists from manga.

Manga Wordlist Extractor

This script allows you to automatically scan through manga and generate a csv with all contained words.

It is intended to be used with the community deck feature of Bunpro, hence the csv format. Once the csv import feature will be published, I will adjust the format of the csv. If any other outputs are desired, let me know!

Usage

You need to have python installed (ideally Python 3.12).

Download this repository (using the "code -> download zip" option above the files list at the top). Open a command prompt in the downloaded folder after extracting.

Run this to install all dependencies:

pip install -r requirements.txt

Once this is done, navigate to the src/main folder in your command prompt. You can now run the tool with this command:

python main.py "FOLDER_PATH"

Replace FOLDER_PATH with the path containing the manga files. If you enter a parent folder containing multiple volumes, add "--parent" before the folder path.

This will generate a vocab.csv file containing all words.

Notices

If you run into errors, look into the mokuro repository linked at the bottom. There might be some issues with python version compatibility.

Also important: This script is not perfect. The text recognition can make mistakes and some of the extracted vocab can be wrong. If this proves to be a big issue I will look for a different method to parse vocabulary from the text.

TODO

• Upload to PyPi and make usage much easier and simpler
• Live Output from Mokuro (it can take very long)
• Separate outputs for each volume
• Added translations through dictionary lookup?

Acknowledgements

This is hardly my work, I just stringed together some amazing libraries:

• mokuro, to extract lines of text from manga - https://github.com/kha-white/mokuro
• nagisa, to extract words from those lines of text - https://pypi.org/project/nagisa/