View Single Post
Old 07-27-2017, 10:01 PM   #1
geek1011
Wizard
geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.geek1011 ought to be getting tired of karma fortunes by now.
 
Posts: 2,730
Karma: 6678757
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
kepubify - A standalone tool to convert ePubs into Kobo ePubs

kepubify
A tool to convert ePubs into Kobo ePubs

DocumentationGitHubDownloadMobileRead Wiki


-----
I have released version 2.0. Please click here to go to it's thread.
Most of the information below on usage does not apply anymore to the new version.
-----

Kepubify is a epub to kepub conversion tool. Kepubify is fast, easy-to-use, and cross platform. Kepubify is written in Go, and released under the MIT license.

I created kepubify because I was not satisfied with the speed of calibre-kobo-driver, and I wanted a faster alternative which can be used from the command line, and does not depend on Calibre. I found most of my information about Kobo ePubs from the source code of calibre-kobo-driver.

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 vitorgalvao/kepubify/kepubify and press enter

Usage
Code:
USAGE: kepubify INPUT_PATH [OUTPUT_PATH]

INPUT_PATH:
The input file or directory. If it is a directory,
OUTPUT_PATH must be a nonexistent directory.

OUTPUT_PATH:
The path to place the converted ebook(s). Can only
be a directory if INPUT_PATH is a directory.

By default, this is the basename of the input file, 
with 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 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 filename:
kepubify /path/to/the/book.epub /path/to/save/the/new/book.kepub.epub
The resulting file will be saved to the specified file.

To convert a single book with a different output folder:
kepubify /path/to/the/book.epub /path/to/save/the/book/
The resulting file will be saved to specified folder.

To batch convert a whole directory of ebooks:
kepubify /path/to/the/books/ /path/to/output/the/converted/books
The output directory must not exist, as it will be created by kepubify. The directory structure of the source
is preserved in the output.

Series metadata
On Linux, you can update the series metadata on the Kobo using seriesmeta. Seriesmeta is available
here. It is used as follows:
seriesmeta /path/to/KOBOeReader

What is different about kepubs?
Kepubs are Kobo's ebook format based on the epub format. This format enables additional features such as chapter progress
stats, time left, faster page turns, 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?
  • 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

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.


Last edited by geek1011; 03-04-2018 at 10:33 AM.
geek1011 is offline   Reply With Quote