bookvert 0.0.6

Conveniently convert a batch of directories into a book formats like .cbz
Documentation

bookvert

A tool to perform batch conversion of books.

This is a .cbz batch conversion tool which scans directories for image files, groups them by their directory and creates books out of them.

You can install bookvert with cargo:

cargo install bookvert

Usage

The idea is that you have a group of semi-structured directories containing lexically sorted image files and you run bookvert against it. Like this:

  • That time I sorted books/Chapter 1/
  • That time I sorted books/Chapter 1 - Fix/
  • That time I sorted books/Chapter 2/

This is available as an example in the examples directory and can be run like this:

cargo run --example examples

We then group all the books into catalogues. A catalogue is determine by all numerical components in the folder name of the book.

So we run bookvert against the examples directory above and there are two folders which will be in catalogue #1. This then prompts bookvert to ask the user to select which one to use:

catalogues select a book

Once you are done, if you set the name to That time I sorted books and you select which directory to use for Chapter 1, bookvert will create That time I sorted books1.cbz and That time I sorted books2.cbz in the specified output directory.

Policies

If you don't like the interactive mode, you can set a pick policy using the --pick argument. This lets you specify how a book should be picked depending on which catalogue it is part of.

For the most up-to-date information, se --help.

Pick books with --pick

Format: [from=]to where from is an book number or range to match.

The range in from is specified as n..m (exclusive), n..=m (inclusive), or n.. (open-ended) or .. (all). The to target can be first, last, most-pages, a zero-based index, or a regular expression for the exact match to pick.

Examples:

  • -p most-pages picks the match with the most pages for all books.
  • -p 3=first picks the first match for book number 3.
  • -p 3=1 picks the second match for book number 3.
  • -p 1..=5=most-pages picks the match with the most pages for books 1 through 5.
  • -p fix will match any book that contains the string fix.