naisuuuu / mangaconv

Manga converter for e-readers

mangaconv

mangaconv is a portable cli tool to convert comic and manga files/folders for reading on e-ink devices.

Currently supported input formats are zip/cbz or a folder of images. Output is a cbz archive.

This project is heavily inspired by KCC. Unlike KCC, it does not require any runtime dependencies and does not attempt to make any internet connections.

Usage

Simple usage:

mangaconv path/to/my/manga.zip another/path/to/my/manga/dir

Configure with flags:

mangaconv -height 1080 -width 1920 path/to/my/manga.zip another/path/to/my/manga/dir

To learn about provided flags:

mangaconv -help

TODOS

This project is still a work in progress.

Notable missing features include:

• epub input / output support
• pdf input support
• memory usage optimization

License

MIT. See LICENSE.

Wikipe-tan image used for testing by Kasuga~enwiki, borrowed from wikimedia under CC BY-SA 3.0.

mangaconv's Issues

Reduce memory usage

Current implementation of the imgutil library copies images with each modification applied. This seems to bloat the memory usage to many times the input size for each image.
I have yet to profile this conclusively, but I suspect modifying the imgutil library to instead operate on images in-place whenever possible should reduce the memory usage significantly.

Epub output

Epub files are a bit larger than corresponding cbz archives, but they provide more functionality. The main feature of epub files I would greatly appreciate is their ability to hold metadata, such as the author, date of release etc.

Don't import images in tests

While it makes sense in benchmarks, this is probably not a very good approach:

mangaconv/imgutil/grayscale_test.go

Lines 90 to 93 in 59a96e8

	{
	"YCbCr",
	mustReadImg("testdata/wikipe-tan-YCbCr.jpg"),
	},

We should inline sufficiently complex input and output images using their appropriate *image.Types.
This is more of a nice-to-have than a functional requirement, so I'm leaving this issue as a reminder for the future.