Kepubify converts EPUBs to KEPUBs. Kepubify is fast, lightweight, easy-to-use, and cross platform.

Features

Installation
Windows:
  1. Download kepubify
Linux:
  1. Download kepubify
  2. Open a terminal
  3. Type cd ~/Downloads (or whatever location you downloaded kepubify to) and press enter
  4. Type chmod +x kepubify-linux-* and press enter
macOS:
  1. Download kepubify
  2. Open a terminal
  3. Type cd ~/Downloads and press enter
  4. Type chmod +x kepubify-darwin-* (or whatever location you downloaded kepubify to) and press enter
macOS (Homebrew):
  1. Open a terminal
  2. Type brew install kepubify and press enter
Usage
Usage: kepubify [OPTIONS] PATH [PATH]...

Options:
  -c, --css string                 custom CSS to add to ebook
      --fullscreen-reading-fixes   enable fullscreen reading bugfixes based on https://www.mobileread.com/forums/showpost.php?p=3113460&postcount=16
  -h, --help                       show this help text
      --hyphenate                  force enable hyphenation
      --inline-styles              inline all stylesheets (for working around certain bugs)
      --no-hyphenate               force disable hyphenation
  -o, --output string              the directory to place the converted files (default ".")
  -u, --update                     don't reconvert files which have already been converted
  -v, --verbose                    show extra information in output
      --version                    show the version

Arguments:
  PATH is the path to an epub file or directory to convert. If it is a directory, the converted
  dir is the name of the dir with the suffix _converted. If the path is a file, the converted
  file has the extension .kepub.epub.
Examples

For the following examples, replace kepubify with the path to the downloaded kepubify.

To convert a single book by dragging and dropping on Windows:
Just drag the original epub file over kepubify.exe. The resulting file will be saved to the same directory as the original epub.

To convert a folder of books by dragging and dropping on Windows:
Just drag the folder over kepubify.exe. The resulting file will be saved to the same directory as the originals, but with the suffix _converted.

To convert a single book:
kepubify /path/to/the/book.epub
The resulting file will be saved to the current directory.

To convert a single book with a different output folder:
kepubify --output "/path/to/save/the/book/" /path/to/the/book.epub
The resulting file will be saved to specified folder (in this example /path/to/save/the/book/).

To convert all books in the current folder into a folder called converted:
kepubify -o "converted" *.epub

To batch convert a directory of ebooks:
kepubify /path/to/the/books/
The converted books will be saved to the original dir with the suffix _converted (e.g. /path/to/the/books_converted).The directory structure of the source is preserved in the output.

To batch convert a directory of ebooks with a different output folder:
kepubify -o "/path/to/output/the/converted/books" /path/to/the/books/
The directory structure of the source is preserved in the output.

To convert a directory of ebooks, but skipping ones which have already been converted:
kepubify --update /path/to/the/books/

Series metadata

On Linux and Windows, you can update the series metadata on the Kobo using seriesmeta. Seriesmeta is available here. It will automatically detect your Kobo when you run it. Seriesmeta doesn't conflict with Calibre, and works on both EPUB and KEPUB books.

Seriesmeta supports Calibre-style (meta[name=calibre:series], meta[name=calibre:series-index]) and EPUB3-style (meta[property=belongs-to-collection], meta[refines][property=collection-type], meta[refines][property=group-position]) series metadata.

New: Seriesmeta doesn't require the books to be already imported anymore! You can now run seriesmeta right after you transfer you books, and the metadata will be updated on the next reboot.

See here for more details.

Cover images

You can pre-generate/re-generate cover images using covergen. Covergen is available here. It will automatically detect your Kobo when you run it. You cam use covergen without using kepubify (i.e. it works with EPUB books and won't conflict with Calibre).

This tool is useful to save time or for when Kobo automatically generates the cover incorrectly (for example taking an image of the first page, or using a generic cover). It can also optionally stretch the covers to a specific aspect ratio for consistency.

See here for more details.

What is different about KEPUBs?

KEPUB is Kobo's ebook format based on EPUB. This format enables additional features such as chapter progress stats, time left, faster page turns, page flipping (hold finger in bottom corner of screen), footnote previews, image zooming, and faster text selection. Also, ePub 3 is only supported using the kepub reader.

Why would I use this over the Calibre kepub output plugin?

If you are already using Calibre heavily to manage your books, kepubify is not for you. You can still use covergen and seriesmeta, though.

Reporting Issues

If you find any issues or have any questions, please report them here, or send me an email at geek1011 (at) outlook.com. Include the kepubify version, the operating system you are using, and if possible, the book which you are having problems with. You can find the version by typing: kepubify --version.