---
title: AdenzuMangaPanelExtractor
emoji: 🕮
colorFrom: green
colorTo: indigo
sdk: gradio
sdk_version: 5.35.0
app_file: app.py
pinned: false
short_description: Adenzu Manga/Comics Panel Extractor (WebUI)
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

___

# Adenzu Manga/Comics Panel Extractor (WebUI)  

Upload your manga or comic book images. This tool will automatically analyze the panels on each page,
crop them into individual image files, and package them into a single ZIP file for you to download.
 
The core panel detection is created by **adenzu** ([Original Project](https://github.com/adenzu/Manga-Panel-Extractor)).

___

# Manga Panel Extractor

A simple program that takes manga pages and outputs panels on them. The current way of working of this program was inspired from this [paper](related-paper.pdf). Thanks to Xufang Pang, Ying Cao, Rynson W.H. Lau, and Antoni B. Chan for their work.

Please read [report](reports/internal/report.pdf) for detailed explanation of the implemented algorithm(s).

- Please note that this program is designed specifically for manga and may not work correctly with manhwas or other similar formats.

## Installation

Visit the [Releases](https://github.com/adenzu/Manga-Panel-Extractor/releases) section of the repository and download the executable for Windows. Currently, only the Windows7+ versions are supported. However, you can build for other platforms using the provided source code.

## Usage

### Website
1. Go to the website https://adenzu.github.io/Manga-Panel-Extractor/
2. Select image files of manga pages you want to extract panels of
3. Click `Start`
4. Click `Cancel` to cancel panel extraction process whenever you want to
5. Click `Download` to download a zip file containing all the panels

- **Note:** Too many images may cause computer lag.

### Executable

0. You can check examples in advance to see if this program can help you with your images, see examples [here](tests/data/test_performance/README.md#what-it-does).
1. [Download the latest executable](https://github.com/adenzu/Manga-Panel-Extractor/releases/latest) for your operating system.
2. Execute the downloaded executable.
3. Select the input directory containing the manga page images. Each image should represent one manga page.
4. Choose the output directory where the extracted panels will be saved.
5. You can check the checkbox named "Split Joint Panels" to split joint panels. **This slows down the process up to ten fold.**
6. You can check the checkbox named "Fallback" for fallback method to be applied in case of a failed extraction.
7. You can check the checkbox named "Output to Separate Folders" to extract each image's panels into their respective folder.
8. Click "Start" to initiate the panel extraction process. You can monitor the progress in the bottom left corner of the program window.
9. To cancel the process, click "Cancel".

- Please note that this program is designed specifically for manga and may not work correctly with manhwas or other similar formats.

### CLI - Input and Output Directories

```bash
python main.py [input_dir] [output_dir] [-s] [-f] [-g]
```

or

```bash
python main.py [input_img_path] [-s] [-f] [-g]
```

- `[input_img_path]`: Input image path.
- `[input_dir]`: Input directory.
- `[output_dir]` (optional): Output directory.
- `-s` or `--split-joint-panels` (optional): Split joint panels.
- `-f` or `--fallback` (optional): Fallback to a more aggressive method if the first one fails.
- `-g` or `--gui` (optional): Use GUI.

## Program Explanation and Examples

See explanation and examples [here](tests/data/test_performance/README.md).

## Features

The key feature of Manga Panel Extractor is its ability to analyze manga pages and extract panels from them.

## Configuration

Manga Panel Extractor does not require any additional configuration. It is ready to use out of the box.

## Contributing

Currently, there is limited community involvement in this project. Feel free to contribute by submitting bug reports or feature requests through the [Issues](https://github.com/adenzu/Manga-Panel-Extractor/issues) section.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Troubleshooting

- If the extraction process is unsuccessful, the output image may resemble the input manga page image itself.

## Contact

If you have any questions, issues, or suggestions, please open an issue in the [Issues](https://github.com/adenzu/Manga-Panel-Extractor/issues) section.