Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Readers > Kobo Reader

Notices

Reply
 
Thread Tools Search this Thread
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: 600
Karma: 1706359
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Kobo Aura Edition 2, Moto G5
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
Advert
Old 07-27-2017, 10:02 PM   #2
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: 600
Karma: 1706359
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Kobo Aura Edition 2, Moto G5
v2.0.0

Changelogs

v1.0.0
Initial release

v1.1.0
1ca2d62 Fix cover image
f685a9f Added 32bit builds
4715b92 Updated feature list
4c78632 Exit on error in release script
3351bc3 Added install to makefile
57e2098 Added thumbnail images to website

v1.1.1
ee08531 Add style tag fixes to html cleaning code
9ea0a38 Fix kobo css
180aa72 Add notes on usage as a library
726e54f Added go report badge to README
59d0a02 Fix spelling mistake
a00fc30 Added license
7dead88 Moved kepub code into a subpackage to allow use as library

v1.1.2
a7b28c3 Added tests for kepub conversion and packing
77ddd91 Added more unit tests
e8a5d1c Improve release script

v1.1.3
9b6d955 CLI fixes
405f3ac Faster progressbar

v1.1.4
7ac7e17 Change delay on windows to 1s
46add9f Fixed commented xml tag (#2)

v1.1.5
d6d9dff Updated dependencies
33f0f9e Added information about Homebrew package (#4)
4e64ae2 Fix spelling

v1.1.6
b893f2a Updated to go 1.9.1

v1.1.7
efbe34e Added seriesmeta to build scripts
8a7d164 Updated readme
1cfb138 Fixes
8b98db2 Updated readme
0939314 Update gitignore
74b0d1c Improvements
29fcbe1 Added support for updating series metadata for all books
3490e5c Started on series metadata update command

v1.2.0
00ec029 Normalize path seperator on Windows (fixes #1)
aa85e8b Update
41805e6 Update
920ca61 Improved seriesmeta cli

v1.3.0
bf6c4fa Added option to convert whole folder of books (closes #8)
af05328 Updated README.md
2a6cfad Fixed segfault when printlog false
4a53aeb Only delay exit on Windows if started with drag and drop
c0e081a Use all CPU cores for conversion (closes #7)

Last edited by geek1011; 03-04-2018 at 10:33 AM.
geek1011 is offline   Reply With Quote
Old 07-28-2017, 12:08 AM   #3
DNSB
Bibliophagist
DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.
 
DNSB's Avatar
 
Posts: 4,488
Karma: 21301182
Join Date: Jul 2010
Location: Vancouver
Device: Kobo Aura One, Aura H2O, Aura HD, Nexus 7 HD, iPad Air, Tolino epos
Any reason for no 32 bit version for Windows? Quite a few of them still around.
DNSB is offline   Reply With Quote
Old 07-28-2017, 12:53 AM   #4
rashkae
Guru
rashkae ought to be getting tired of karma fortunes by now.rashkae ought to be getting tired of karma fortunes by now.rashkae ought to be getting tired of karma fortunes by now.rashkae ought to be getting tired of karma fortunes by now.rashkae ought to be getting tired of karma fortunes by now.rashkae ought to be getting tired of karma fortunes by now.rashkae ought to be getting tired of karma fortunes by now.rashkae ought to be getting tired of karma fortunes by now.rashkae ought to be getting tired of karma fortunes by now.rashkae ought to be getting tired of karma fortunes by now.rashkae ought to be getting tired of karma fortunes by now.
 
rashkae's Avatar
 
Posts: 612
Karma: 3210123
Join Date: Jun 2011
Location: Ontario, Canada
Device: Kobo Aura HD
The one big deficiency I find with the Calibre Kepub output is that it does not fix the TOC. It would be nice if a Kepub output program modified the TOC to include some kind of generic label entry for all files not already in the TOC, (slotted in the correct order.)

I realize that's probably a little tricky to code.
rashkae is offline   Reply With Quote
Old 07-28-2017, 01:46 AM   #5
DNSB
Bibliophagist
DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.
 
DNSB's Avatar
 
Posts: 4,488
Karma: 21301182
Join Date: Jul 2010
Location: Vancouver
Device: Kobo Aura One, Aura H2O, Aura HD, Nexus 7 HD, iPad Air, Tolino epos
Quote:
Originally Posted by rashkae View Post
The one big deficiency I find with the Calibre Kepub output is that it does not fix the TOC. It would be nice if a Kepub output program modified the TOC to include some kind of generic label entry for all files not already in the TOC, (slotted in the correct order.)

I realize that's probably a little tricky to code.
I'd rather have the utility remove HTML TOCs which do popups when reading a kepub -- it's hard to tell a touching a chapter item in the HTML TOC from touching a footnote. Or are you referring to creating an EPUB3 navigation document including all files?

I would prefer not to have 5 or so TOC entries referring to the cover image, books by, acknowledgments, copyright, etc. prior to the prologue/first chapter/whatever.
DNSB is offline   Reply With Quote
Advert
Old 07-28-2017, 02:27 AM   #6
davidfor
Grand Sorcerer
davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.
 
Posts: 14,524
Karma: 24607224
Join Date: Jul 2011
Location: Sydney, Australia
Device: Kobo: Touch, Glo, Aura H2O, Glo HD, Aura ONE
Quote:
Originally Posted by DNSB View Post
I'd rather have the utility remove HTML TOCs which do popups when reading a kepub -- it's hard to tell a touching a chapter item in the HTML TOC from touching a footnote. Or are you referring to creating an EPUB3 navigation document including all files?

I would prefer not to have 5 or so TOC entries referring to the cover image, books by, acknowledgments, copyright, etc. prior to the prologue/first chapter/whatever.
From the very few rules we have for kepubs, every file is supposed to have a ToC entry. In some purchased books, I've seen things like "unnamed chapter" or the first line of text as the title. I think Kobo's publishing routines are adding these as needed. If there are missing entries, you can get some strange things happening with the chapters and page counts. (I might have to check that as it has been a while).
davidfor is online now   Reply With Quote
Old 07-28-2017, 06:47 AM   #7
Raymond73
Junior Member
Raymond73 ought to be getting tired of karma fortunes by now.Raymond73 ought to be getting tired of karma fortunes by now.Raymond73 ought to be getting tired of karma fortunes by now.Raymond73 ought to be getting tired of karma fortunes by now.Raymond73 ought to be getting tired of karma fortunes by now.Raymond73 ought to be getting tired of karma fortunes by now.Raymond73 ought to be getting tired of karma fortunes by now.Raymond73 ought to be getting tired of karma fortunes by now.Raymond73 ought to be getting tired of karma fortunes by now.Raymond73 ought to be getting tired of karma fortunes by now.Raymond73 ought to be getting tired of karma fortunes by now.
 
Posts: 9
Karma: 2072578
Join Date: Jul 2016
Location: Netherlands
Device: Kobo Glo HD, Aura H2O, Tolino Vision 3HD, Kindle Voyage, Kobo Aura ONE
Does kepubify also prevent hyphenation? Because that's the main reason for using the kobo extended driver in my case
Raymond73 is offline   Reply With Quote
Old 07-28-2017, 07:05 AM   #8
Semwize
Zealot
Semwize is as sexy as a twisted cruller doughtnut.Semwize is as sexy as a twisted cruller doughtnut.Semwize is as sexy as a twisted cruller doughtnut.Semwize is as sexy as a twisted cruller doughtnut.Semwize is as sexy as a twisted cruller doughtnut.Semwize is as sexy as a twisted cruller doughtnut.Semwize is as sexy as a twisted cruller doughtnut.Semwize is as sexy as a twisted cruller doughtnut.Semwize is as sexy as a twisted cruller doughtnut.Semwize is as sexy as a twisted cruller doughtnut.Semwize is as sexy as a twisted cruller doughtnut.
 
Posts: 103
Karma: 15422
Join Date: Jun 2016
Device: Kobo Glo HD
Kobo then does not see the books created by your utility. What am i doing wrong?
Semwize is online now   Reply With Quote
Old 07-28-2017, 07:46 AM   #9
trekk
Addict
trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.
 
trekk's Avatar
 
Posts: 371
Karma: 642947
Join Date: Aug 2011
Device: KOA2, KOA, KA1 ...
I got a "no permission" message in my terminal, so I had to chmod kepubify on my mac. Conversion is very fast, but without the possibility of a batch conversion, Calibre is faster when converting multiple files. Nice tool though!

Edit: I also realized that the new .kepubs don't show a thumbnail of the cover on my KA1.

Last edited by trekk; 07-28-2017 at 07:56 AM.
trekk is offline   Reply With Quote
Old 07-28-2017, 08:05 AM   #10
davidfor
Grand Sorcerer
davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.davidfor ought to be getting tired of karma fortunes by now.
 
Posts: 14,524
Karma: 24607224
Join Date: Jul 2011
Location: Sydney, Australia
Device: Kobo: Touch, Glo, Aura H2O, Glo HD, Aura ONE
Quote:
Originally Posted by trekk View Post
Edit: I also realized that the new .kepubs don't show a thumbnail of the cover on my KA1.
@geek1011: Covers work differently for kepubs to epubs. The OPF needs an extra property set on the cover and the image is used. Based on inspecting purchased books, below is what the extended driver does:

Code:
<item href="cover.jpeg" id="cover" media-type="image/jpeg" properties="cover-image"/>
davidfor is online now   Reply With Quote
Old 07-28-2017, 08:28 AM   #11
patrik
Addict
patrik can differentiate black from dark navy bluepatrik can differentiate black from dark navy bluepatrik can differentiate black from dark navy bluepatrik can differentiate black from dark navy bluepatrik can differentiate black from dark navy bluepatrik can differentiate black from dark navy bluepatrik can differentiate black from dark navy bluepatrik can differentiate black from dark navy bluepatrik can differentiate black from dark navy bluepatrik can differentiate black from dark navy bluepatrik can differentiate black from dark navy blue
 
Posts: 295
Karma: 13164
Join Date: Jan 2010
Device: Kobo Aura HD
[QUOTE=trekk;3559609]Conversion is very fast, but without the possibility of a batch conversion, Calibre is faster when converting multiple files. Nice tool though!


Code:
#!/bin/bash
for i in *.epub; do kepubify "$i"; done
patrik is offline   Reply With Quote
Old 07-28-2017, 08:39 AM   #12
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: 600
Karma: 1706359
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Kobo Aura Edition 2, Moto G5
Quote:
Originally Posted by davidfor View Post
@geek1011: Covers work differently for kepubs to epubs. The OPF needs an extra property set on the cover and the image is used. Based on inspecting purchased books, below is what the extended driver does:

Code:
<item href="cover.jpeg" id="cover" media-type="image/jpeg" properties="cover-image"/>
Oops, I missed that. I'll fix that and add a 32 bit now.

Sent from my XT1527 using Tapatalk
geek1011 is offline   Reply With Quote
Old 07-28-2017, 09:07 AM   #13
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: 600
Karma: 1706359
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Kobo Aura Edition 2, Moto G5
Thanks to everyone's feedback so far, I have fixed a few bugs and released version 1.1.0.

v1.1.0
1ca2d62 Fix cover image
f685a9f Added 32bit builds
4715b92 Updated feature list
4c78632 Exit on error in release script
3351bc3 Added install to makefile
57e2098 Added thumbnail images to website
geek1011 is offline   Reply With Quote
Old 07-28-2017, 09:09 AM   #14
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: 600
Karma: 1706359
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Kobo Aura Edition 2, Moto G5
Quote:
Originally Posted by DNSB View Post
Any reason for no 32 bit version for Windows? Quite a few of them still around.
Fixed in v1.1.0
geek1011 is offline   Reply With Quote
Old 07-28-2017, 09:11 AM   #15
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: 600
Karma: 1706359
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Kobo Aura Edition 2, Moto G5
Quote:
Originally Posted by Semwize View Post
Kobo then does not see the books created by your utility. What am i doing wrong?
Have you copied the book to your kobo?
geek1011 is offline   Reply With Quote
Reply

Tags
conversion, epub, kepub, tool

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Aura H2O Font size mismatch (downloaded epubs via Calibre vs. Kobo epubs & articles) Oolong Kobo Reader 23 04-23-2017 08:03 PM
Tool to automatically download and check epubs skreutzer Workshop 26 12-14-2015 12:28 PM
Touch Problem with all epubs, my epubs, or my kobo? (line clipping) plague006 Kobo Reader 14 12-02-2011 11:32 PM
Epub check tool: ePubs do not pass Portnull Calibre 32 11-04-2009 08:27 AM


All times are GMT -4. The time now is 08:00 AM.


MobileRead.com is a privately owned, operated and funded community.