07-27-2017, 10:01 PM | #1 |
Wizard
Posts: 2,788
Karma: 6990707
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 Documentation • GitHub • Download • MobileRead 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:
Linux:
macOS:
macOS (Homebrew):
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 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?
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. |
07-27-2017, 10:02 PM | #2 |
Wizard
Posts: 2,788
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
|
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. |
Advert | |
|
07-28-2017, 12:08 AM | #3 |
Bibliophagist
Posts: 39,853
Karma: 154147706
Join Date: Jul 2010
Location: Vancouver
Device: Kobo Sage, Libra Colour, Lenovo M8 FHD, Paperwhite 4, Tolino epos
|
Any reason for no 32 bit version for Windows? Quite a few of them still around.
|
07-28-2017, 12:53 AM | #4 |
Wizard
Posts: 1,215
Karma: 5372649
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. |
07-28-2017, 01:46 AM | #5 | |
Bibliophagist
Posts: 39,853
Karma: 154147706
Join Date: Jul 2010
Location: Vancouver
Device: Kobo Sage, Libra Colour, Lenovo M8 FHD, Paperwhite 4, Tolino epos
|
Quote:
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. |
|
Advert | |
|
07-28-2017, 02:27 AM | #6 | |
Grand Sorcerer
Posts: 24,905
Karma: 47303822
Join Date: Jul 2011
Location: Sydney, Australia
Device: Kobo:Touch,Glo, AuraH2O, GloHD,AuraONE, ClaraHD, Libra H2O; tolinoepos
|
Quote:
|
|
07-28-2017, 06:47 AM | #7 |
Member
Posts: 10
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
|
07-28-2017, 07:05 AM | #8 |
Guru
Posts: 884
Karma: 270656
Join Date: Jun 2016
Device: Kobo
|
Kobo then does not see the books created by your utility. What am i doing wrong?
|
07-28-2017, 07:46 AM | #9 |
Terraner
Posts: 529
Karma: 4455667
Join Date: Aug 2011
Device: Kobo Libra, Aura One, Kindle Oasis 1 & 2 ...
|
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. |
07-28-2017, 08:05 AM | #10 | |
Grand Sorcerer
Posts: 24,905
Karma: 47303822
Join Date: Jul 2011
Location: Sydney, Australia
Device: Kobo:Touch,Glo, AuraH2O, GloHD,AuraONE, ClaraHD, Libra H2O; tolinoepos
|
Quote:
Code:
<item href="cover.jpeg" id="cover" media-type="image/jpeg" properties="cover-image"/> |
|
07-28-2017, 08:28 AM | #11 |
Guru
Posts: 673
Karma: 4568205
Join Date: Jan 2010
Location: Sweden
Device: Kobo Forma
|
[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 |
07-28-2017, 08:39 AM | #12 | |
Wizard
Posts: 2,788
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
|
Quote:
Sent from my XT1527 using Tapatalk |
|
07-28-2017, 09:07 AM | #13 |
Wizard
Posts: 2,788
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
|
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 |
07-28-2017, 09:09 AM | #14 |
Wizard
Posts: 2,788
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
|
|
07-28-2017, 09:11 AM | #15 |
Wizard
Posts: 2,788
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
|
|
Tags |
conversion, epub, kepub, tool |
|
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 | 36 | 01-25-2019 06:00 AM |
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 |