View Single Post
Old 01-17-2020, 09:00 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,801
Karma: 6990707
Join Date: May 2016
Location: Ontario, Canada
Device: Kobo Mini, Aura Edition 2 v1, Clara HD
kepubify v3: A fast, standalone EPUB to KEPUB converter (plus covergen/seriesmeta)

kepubify (v3)
Kepubify converts EPUBs to KEPUBs. Kepubify also includes two standalone utilities: covergen (which pre-generates cover images), and seriesmeta (which updates the database with Calibre or EPUB3 series metadata).
___



Features:
  • Batch conversion
  • Standalone and cross platform
  • Works from the command line or by dragging and dropping on Windows
  • Fast (15x faster than converting in Calibre)
  • Add custom CSS
  • Smarten punctuation
  • Can optionally pre-convert books for use in Calibre
  • Complete control over output structure (see here for detailed examples)
  • Almost identical output compared to original Kobo KEPUBs
  • Standalone tool to pre-generate cover images (including aspect ratio changes, grayscale, and color inversion) (you can use this without kepubify)
  • Standalone tool to update the database with Calibre or EPUB3 series metadata (you can use this without kepubify)

Usage (Windows) (drag and drop):
  1. Download kepubify from the releases page.
  2. Drag your EPUB files on to the EXE you downloaded in Windows Explorer to convert them.
  3. Optionally, to use covergen or seriesmeta, download the binary and run it.

Usage (Windows):
  1. Download kepubify from the releases page.
  2. Open a Command Prompt window in the folder you downloaded the EXE into.
  3. Type "kepubify" and press enter to see the available options.

Usage (Linux/macOS):
  1. Download kepubify from the releases page.
  2. Open a terminal window in the folder you downloaded, and run "chmod +x kepubify-*". If you're on macOS, you can also type "chmod +x ", drag kepubify-darwin-64bit on to the terminal, and press enter.
  3. Type "./kepubify" (or drag and drop kepubify-darwin-64bit), and press enter to see the available options. If you're on macOS, you may need to allow kepubify through GateKeeper under System Preferences > Security.

Full usage info:
Code:
Usage: kepubify [options] input_path [input_path]...

Version:
  kepubify v3.1.0

General Options:
  -v, --verbose   Show extra information in output
      --version   Show the version
  -h, --help      Show this help text

Output Options:
  -u, --update             Don't reconvert files which have already been converted (i.e. don't overwrite output files)
  -i, --inplace            Don't add the _converted suffix to converted files and directories
      --no-preserve-dirs   Flatten the directory structure of the input (an error will be shown if there are conflicts)
  -o, --output string      [>1 inputs || 1 file input with existing dir output]: Directory to place converted files/dirs under; [1 file input with
                           nonexistent output]: Output filename; [1 dir input]: Output directory for contents of input (default: current directory)
      --calibre            Use .kepub instead of .kepub.epub as the output extension (for Calibre compatibility, only use if you know what you are doing)
  -x, --copy strings       Copy files with the specified extension (with a leading period) to the output unchanged (no effect if the filename ends up the same)

Conversion Options:
      --smarten-punctuation        Smarten punctuation (smart quotes, dashes, etc) (excluding pre and code tags)
  -c, --css stringArray            Custom CSS to add to ebook
      --hyphenate                  Force enable hyphenation
      --no-hyphenate               Force disable hyphenation
      --fullscreen-reading-fixes   Enable fullscreen reading bugfixes based on https://www.mobileread.com/forums/showpost.php?p=3113460&postcount=16
  -r, --replace stringArray        Find and replace on all html files (repeat any number of times) (format: find|replace)
Seriesmeta:
Spoiler:
Code:
Usage: seriesmeta [options] [kobo_path]

Version:
  seriesmeta v3.1.0

Options:
  -h, --help         Show this help message
  -p, --no-persist   Don't ensure metadata is always set (this will cause series metadata to be lost if opening a book after an import but before a reboot)
  -n, --no-replace   Don't replace existing series metadata (you probably don't want this option)
  -u, --uninstall    Uninstall seriesmeta table and hooks (imported series metadata will be left untouched)

Arguments:
  kobo_path is the path to the Kobo eReader. If not specified, seriesmeta will try to automatically detect the Kobo.


Covergen:
Spoiler:
Code:
Usage: covergen [options] [kobo_path]

Version:
  covergen v3.1.0

Options:
  -a, --aspect-ratio float   Stretch the covers to fit a specific aspect ratio (for example 1.3, 1.5, 1.6)
  -g, --grayscale            Convert images to grayscale
  -h, --help                 Show this help message
  -i, --invert               Invert images
  -m, --method string        Resize algorithm to use (bilinear, bicubic, lanczos2, lanczos3) (default "lanczos3")
  -r, --regenerate           Re-generate all covers

Arguments:
  kobo_path is the path to the Kobo eReader. If not specified, covergen will try to automatically detect the Kobo.


What features do KEPUBs offer?
  • Faster page turning
  • Book progress panel and chapter graph
  • Pop-up footnotes (on books which support it)
  • Double-tap to zoom images
  • Faster text selection
  • A few other features

Download | Website

Last edited by geek1011; 07-14-2020 at 04:53 PM.
geek1011 is offline   Reply With Quote