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: 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.

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/

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.

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.

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.

• Calibre adds additional unnecessary metadata to the ebook
• Kepubify is usually at least 12x faster than the Calibre plugin
• Kepubify works from the command line
• Kepubify removes leftover Adobe DRM tags, cleans up MS Word tags, and cleans up the html
• Calibre is an enourmous program, which is unnecessary if all you want to do is convert books
• Kepubify is written in Go, which is a compiled language
• Kepubify can update the series metadata on your Kobo without managing your whole library
• Kepubify is easier to customize

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

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.