ManhwaOCR

an app that lets you MTL your manhwa with ease. designed with simplicity at its core .

Table of Contents

• ManhwaOCR
  • Table of Contents
• Workflow
  • Create Project
  • Start the OCR
  • Configure and Translate with Gemini API (Free!)
  • Apply Translation and Save Manhwa
• Installation Guide
  • Prerequisites
  • Step 1: Clone the Repository
  • Step 2: Install Required Dependencies
  • Step 3: Run the Application
  • Optional: Compile and Install the Launcher
    • Compiling with Nuitka
  • Troubleshooting
    • 1. Some Text is Not Detected
    • 2. EasyOCR Does Not Work as Intended
    • 3. PyQt5 Installation Issues
    • 4. Missing Dependencies
  • Roadmap
  • Notes
  • Contributing

---

Workflow

Create Project

Landing.page.mp4

Start the OCR

Start.OCR.mp4

Configure and Translate with Gemini API (Free!)

yes, gemini api is free. if you still haven't made one, what are you waiting for!?!

Translate.With.Gemini.API.mp4

Apply Translation and Save Manhwa

Apply.Translation.and.Save.mp4

---

Installation Guide

This guide will help you set up and run the Manhwa OCR Tool on your system. Follow the steps below to install all necessary dependencies and execute the application.

Prerequisites

Before proceeding, ensure that you have the following installed on your system:

• Python 3.12 or higher: You can download it from python.org.
• pip: Python's package installer (usually included with Python).

Verify your Python and pip installations by running the following commands in your terminal:

python --version
pip --version

If these commands return version numbers, you're good to proceed.

---

Step 1: Clone the Repository

Clone this repository to your local machine using the following command:

git clone https://github.com/Liiesl/ManhwaOCR.git
cd ManhwaOCR

Step 2: Install Required Dependencies

Install core dependencies with a single command:```bash pip install PyQt5 qtawesome easyocr numpy Pillow google-generativeai

**For EasyOCR** (requires system dependencies):
```bash
pip install easyocr

⚠️ IMPORTANT: Follow EasyOCR's GitHub instructions closely (especially windows user, please read their note).

---

Verify Installation Run this command to check all core dependencies:

python -c "import PyQt5, Pillow, easyocr, numpy, qtawesome, google-generativeai; print('All dependencies installed successfully!')"

If no errors appear, you're ready to proceed. (Note: EasyOCR requires additional system dependencies - verify its functionality by processing an image)

---

Step 3: Run the Application

Once all dependencies are installed, you can run the application using the following command:

python main.py

This will launch the Manhwa OCR Tool GUI. From here, you can open a folder containing images, process OCR, and apply translations as described in the tool's documentation.

---

Optional: Compile and Install the Launcher

For a more integrated experience, you can compile the provided launcher. This will create a standalone executable that you can associate with .mmtl files, allowing you to open them directly. The launcher is located in the launcher/ directory.

I recommend using Nuitka for compilation as it offers better performance and compatibility, but PyInstaller is also a viable option.

Compiling with Nuitka

1. Install Nuitka and PySide6: The launcher uses PySide6 to remain lightweight.

   pip install nuitka pyside6

2. Run the Compilation Command: From the root directory of the project, run the following command:

   python -m nuitka --onefile --plugin-enable=pyside6 --windows-icon-from-ico=app_icon.ico --company-name="YourCompany" --product-name="MangaOCRTool Launcher" --file-description="Launcher for ManhwaOCR" --file-version="1.0.0.0" --product-version="1.0.0.0" --output-filename="mmtl_launcher.exe" mmtl_launcher.py

   This will generate a single executable file in the mmtl_launcher.dist folder. Move this file to a permanent location (e.g., the ManhwaOCR root folder or C:\Program Files\ManhwaOCR).

3. Set File Association (Windows): To open .mmtl files with a double-click, you need to associate the file type with the new launcher.

   • Find any .mmtl file on your system.
   • Right-click the file and select Open with > Choose another app.
   • Check the box that says "Always use this app to open .mmtl files".
   • Scroll down and click "Look for another app on this PC".
   • Navigate to the location where you saved mmtl_launcher.exe and select it.

Now, all .mmtl files will open directly with the launcher.

Note on Dependencies: The main application uses PyQt5, while the launcher uses PySide6. This is by design to accommodate Nuitka's features. If you prefer to use only PyQt5, you can modify mmtl_launcher.py by replacing all instances of PySide6 with PyQt5.

---

Troubleshooting

Below are solutions to common issues you may encounter while using this tool. If your problem isn't listed here, consider opening an issue on the repository for further assistance.

1. Some Text is Not Detected

This issue typically occurs when the default settings do not align with the characteristics of your desired manhwa. While the default settings work for most manhwa, some may have unique layouts or text styles that require adjustments.

Solution: Navigate to Settings > OCR Processing and fine-tune the settings to better match the characteristics of your manhwa. Experiment with parameters such as text size, font style, or alignment to improve detection accuracy.

2. EasyOCR Does Not Work as Intended

If EasyOCR does not function correctly, the issue is often related to an incompatible or missing installation of PyTorch. EasyOCR relies on PyTorch for its core functionality, so ensuring the correct version is installed is crucial.

Solution:

1. Visit the EasyOCR GitHub Installation Guide for detailed instructions.

2. Download and install the correct version of PyTorch for your system by following the official PyTorch Get Started guide. Ensure you select the appropriate configuration (e.g., OS, Python version, CUDA support).

3. Once PyTorch is installed, retry installing EasyOCR:

   pip install easyocr

Note: If you're using a GPU, verify that your CUDA drivers are up-to-date and compatible with the installed version of PyTorch. For CPU-only setups, choose the corresponding PyTorch variant during installation.

3. PyQt5 Installation Issues

If PyQt5 installation fails, try installing it with the following command:

pip install PyQt5==5.15.11

This specifies a stable version of PyQt5.

4. Missing Dependencies

If you encounter any "ModuleNotFoundError" during runtime, it means a required library is missing. Use the error message to identify the missing module and install it using pip.

---

Roadmap

To see the current development progress, planned features, and what's coming next, please refer to the todo.md file.

---

Notes

• Images Files: Ensure that all images in the selected folder are in supported formats (e.g., PNG, JPG, JPEG).
• Explore Settings to finds a lot of configurable for the app.
• OCR processing may take some time depending on the number of images and their sizes.
• Environment Compatibility: Ensure your Python environment meets the minimum requirements for this tool.
• Logs and Debugging: If you're still facing issues, enable debug logging (if available) to gather more information about the problem.
• Community Support: For unresolved issues, feel free to open an issue on the repository. Include detailed steps to reproduce the problem, along with any relevant logs or screenshots.

---

Contributing

Feel free to contribute to this project by submitting pull requests or opening issues in the repository.

Package distributor are needed. if you're proficient in the field please leave comment in discussion.

---

That's it! You should now have a fully functional Manhwa OCR Tool installed on your system. Happy translating