mangafmt is a Go-based command-line program to format a manga file and optimized for reading on E-Ink reader (and possibly other devices).
- Detect double-page spread (a big scene that covers two facing pages) heuristically and connect them into one landscape page.
- Trim blank spaces around the edges for better.
- Resize/rotate page to fit specific screen size.
- Reduce file size by reducing colors to grayscale (except the cover page or configured otherwise).
- Handle right-to-left (RTL) read direction.
- Convert to EPUB/KEPUB/CBZ format.
- Support Windows/OSX/Linux
- Input File
- Output File
- EPUB
- KEPUB
- CBZ
- RAW (a directory of image files)
./mangafmt [options] <input_pdf_file>
-background string
Background color(s) separated by comma. The first color is the main background color. (default "#FFFFFF,#000000")
-density float
Output density (DPI) (default 300)
-format value
Output file format. The supported formats
- raw (default)
- cbz
- epub
- kepub
-fuzz float
Color fuzz (percentage)[0.0-1.0] (default 0.1)
-grayscale string
Page range (Ex. '4-10, 15, 39-') to convert to grayscale. Default is all pages except the first page(cover). 'false' means no grayscale conversion (default "2-")
-grayscale-depth uint
Grayscale color depth in number of bits. Possible values are 1, 2, 4, 8, 16 bits. No upscale if source image is in lower depth. (default 4)
-h Show help
-height uint
Output screen heigt (pixel) (default 1680)
-help
Show help
-output string
Output file. Unspecified or blank means using the same file name as input file
-pages string
Page range (Ex. '4-10, 15, 39-'). Default is all pages. Open right range means to the end. (default "1-")
-right-to-left
Right-to-left read direction (ex. Japanese manga)
-rtl
Right-to-left read direction (ex. Japanese manga)
-spread
Enable double-page spread detection and connection (default true)
-spread-bg-distortion --background
A page is considered a single page if the distortion between its edge and background color are less than this threshold (percentage)[0.0-1.0].
Multiple values are separated by comma. It should match with --background otherwise the last value is used for the rest of the list. (default "0.4,0.2")
-spread-edge uint
Edge width for double-page spread detection (pixel) (default 2)
-spread-lr-distortion float
Two pages are considered double-page spread if the distortion between their edges are less than this threshold (percentage)[0.0-1.0] (default 0.4)
-spread-margin uint
Safety margin before edge width (pixel) (default 2)
-title string
Book title. This affects epub/kepub output. Unspecified or blank means using filename without extension
-trim
Enable trim edge (default true)
-trim-margin int
Safety trim margin (pixel) (default 10)
-trim-min-size float
Minimum size after trimmed (percentage)[0.0-1.0] (default 0.85)
-v Verbose output
-verbose
Verbose output
-version
Show version
-width uint
Output screen width (pixel) (default 1264)
-work-dir string
Work directory path. Unspecified or blank means using system temp path
There are two ways to install.
Download the pre-built binary from Releases Page
go install github.com/teerapap/mangafmt@latest
For PDF input, you need to install one of these options.
- libvips (Fastest)
- For Windows, you need to install the version with
-allsuffix and configurePATHenvironment variable to seevips.execommand.
- For Windows, you need to install the version with
- ImageMagick7 and Ghostscript
- ImageMagick6 and Ghostscript
- Not recommended for Windows because its
convert.exemay clash with the systemconvert.exe
- Not recommended for Windows because its
The code is pure Go so simply run
go build
- Support raw images in a directory input
- Support CBZ input format
- Support EPUB/KEPUB input format
I developed this tool for my personal use so all default values cater for my own usage. However, I'd be happy if this tool is useful for other fellow manga readers too. 😄
I strongly condemn manga piracy and hope you won't use this tool for any illegal purposes. Please remember to always support and respect the hard work of manga artists.
If you found any bugs, please feel free to report an issue and I'll fix it when time permits.