2023-10-23 05:28:53 +00:00
|
|
|
# Mex
|
|
|
|
|
2023-10-24 02:57:39 +00:00
|
|
|
Mex is a tool for repacking manga archives into a sane directory structure for consumptions by viewers like
|
|
|
|
[Komga](https://komga.org/), [Kavita](https://www.kavitareader.com/), and many others.
|
2023-10-23 05:28:53 +00:00
|
|
|
|
|
|
|
![](img/mex.png)
|
|
|
|
|
|
|
|
## Requirements
|
|
|
|
|
2023-10-24 02:57:39 +00:00
|
|
|
You must have both `7za` / `7z` and `unrar` installed on your system and included in your system `PATH`.
|
2023-10-23 05:28:53 +00:00
|
|
|
|
|
|
|
## Features
|
|
|
|
|
2023-10-24 02:57:39 +00:00
|
|
|
* Process most compressed formats, including nested archives 🌮
|
|
|
|
* Detect best quality volumes in the presence of duplicates 🌶️
|
|
|
|
* Rename volumes and pages using templates for consistency 🫔
|
|
|
|
* Exclude any irrelevant garbage files present in your archives 🥑
|
|
|
|
* Output loose images, CBZ archives, or a combination of both 🌯
|
2023-10-23 05:28:53 +00:00
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
2023-10-24 02:57:39 +00:00
|
|
|
To process an archive just pass it on the command line to Mex:
|
|
|
|
|
|
|
|
```
|
|
|
|
mex my_manga_archive.rar
|
|
|
|
```
|
|
|
|
|
|
|
|
Additional options can be viewed by running with the `-help` flag:
|
|
|
|
|
2023-10-23 05:28:53 +00:00
|
|
|
```
|
|
|
|
Usage: mex <input_path> [<output_dir>]
|
|
|
|
-label-book string
|
|
|
|
book name template (default "{{.Name}}")
|
|
|
|
-label-page string
|
|
|
|
page name template (default "page_{{.Index}}{{.Ext}}")
|
|
|
|
-label-volume string
|
|
|
|
volume name template (default "vol_{{.Index}}")
|
|
|
|
-workers int
|
|
|
|
number of simultaneous workers (default 4)
|
|
|
|
-zip-book
|
|
|
|
compress book as a cbz archive
|
|
|
|
-zip-volume
|
|
|
|
compress volumes as cbz archives (default true)
|
|
|
|
Templates:
|
|
|
|
{{.Index}} - index of current volume or page
|
|
|
|
{{.Name}} - original filename and extension
|
|
|
|
{{.Ext}} - original extension only
|
|
|
|
```
|