epub2mobi

Package: WA2L/WinTools 1.2.08
Section: General Commands (1)
Updated: 26 August 2019
Index Return to Main Contents

 

NAME

epub2mobi - convert eBooks from ePUB to MOBI format

 

SYNOPSIS

WA2LWinTools/bin/epub2mobi [ -h | -i | -u | -V ]

epub2mobi [ -n ][ file... ]

 

AVAILABILITY

WA2L/WinTools

 

DESCRIPTION

convert one or more *.epub file(s) to *.mobi file(s).

The epub2mobi command provides a fast and efficient way to convert one or more ePUB eBooks to the MOBI file format that can be processed by the Kindle eBook reader from Amazon.

To convert eBook(s): mark them in the Windows™ Explorer, -> do a right click -> goto: 'Send to' -> select: 'epub2mobi'.

Each given file1.epub is converted to file1.mobi as long as the destination file ( file1.mobi ) does not exist already.

The epub2mobi command should be installed to the 'Send To' context menu in 'Microsoft™ Windows Explorer' for most convenient usage. To do so, invoke epub2mobi -i once.

 

OPTIONS

-h
usage message.

-i
install the epub2mobi command as menu point 'epub2mobi' to the 'Send To' context menu in 'Windows Explorer'.

-u
uninstall the epub2mobi shortcut from the 'Send To' context menu in 'Windows Explorer'.

-V
print program version.

-n
non interactive execution. This prevents the message box dialog at the end of the program execution. Using -n the epub2mobi command can be used in batch processing without any user intervention.

file...
list of *.epub files to convert to *.mobi . When installed in the 'Send To' menu the selected file(s) in 'Windows Explorer' are passed as a list of files to the epub2mobi command and all given ePUB files are converted and saved as a separate MOBI file.

If - is specified as file name, the file list is read from stdin (standard input).

If no file is specified, you are queried to select the file(s) by a open file box dialog where you then can select the file(s) to be processed.

 

ENVIRONMENT

-

 

EXIT STATUS

0
no error.

1
files were skipped or conversion failed.

2
shortcut in 'SendTo' menu could not be removed.

4
usage message displayed.

5
program version printed.

6
program variant not known. This error occurs when the epub2mobi command is renamed.

 

FILES

-

 

EXAMPLES

1) common usage: convert selected ePUB eBooks in a directory using the 'Send To' menu

This is the most convenient usage to convert one or more ePUB files to the MOBI eBook format.

start: Windows Explorer
  -> browse: to your eBook directory
  -> mark: *.epub files to be converted
  -> right click
  -> goto: 'Send to'
  -> select: 'epub2mobi'

2) common usage: convert a single ePUB eBook starting epub2mobi thru the Windows™ 'Start' Menu

If the epub2mobi command was not installed to the 'Send To' context menu of Windows™ Explorer this method can be used to select and convert single ePUB eBooks to the MOBI format.

goto: Windows 'Start Menu'
  -> goto: WA2LWinTools
  -> start: 'epub2mobi'
  -> select: *.epub file in file dialog
  -> [ OK ]

3) common usage: convert a single ePUB eBook starting epub2mobi thru a double click on the epub2mobi command

If the epub2mobi command was not installed to the 'Send To' context menu of Windows™ Explorer and there is also not a 'Start Menu' configured for the WA2L/WinTools package, this method can be used to select and convert single ePUB eBooks to the MOBI format.

start: Windows Explorer
  -> browse: to WA2LWinTools\bin\
  -> start: epub2mobi
  -> select: *.epub file in file dialog
  -> [ OK ]

4) advanced usage: efficiently convert all ePUB books below a certain directory using the command line

The command line usage of the epub2mobi command provides some possibilities that allows some very efficient methods to convert eBooks.

Start wtshell or Console:

goto: Windows 'Start Menu'
  -> goto: WA2LWinTools
  -> start: wtshell or Console

[ C:\Users\fred\Desktop\WA2LWinTools\bin ]
[ fred@ACME ][*wtshell*/cmd]:

Change to the base directory where the ePUB books reside:

[ C:\Users\fred\Desktop\WA2LWinTools\bin ]
[ fred@ACME ][*wtshell*/cmd]: cd /d C:\Users\fred\Documents\my EBooks

List all ePUB books in that directory and in any directory below that (optional, this is only done to verify which books will be converted in the following step):

[ C:\Users\fred\Documents\my EBooks ]
[ fred@ACME ][*wtshell*/cmd]: dir /s /b *.epub

Convert all *.epub eBooks:

[ C:\Users\fred\Documents\my EBooks ]
[ fred@ACME ][*wtshell*/cmd]: dir /s /b *.epub | epub2mobi -

Alternatively you can also specify the path in the dir command as follows. Doing that you don't have to change to the directory first:

[ C:\Users\fred\Desktop\WA2LWinTools\bin ]
[ fred@ACME ][*wtshell*/cmd]:  dir /s /b "C:\Users\fred\Documents\my EBooks" *.epub | epub2mobi -

Quit the wtshell again:

[ C:\Users\fred\Documents\my EBooks ]
[ fred@ACME ][*wtshell*/cmd]: quit

 

SEE ALSO

wintoolsintro(1), config(1m), epub2mobi.cfg(4), office2pdf(1), ppt2png(1), xps2pdf(1), xps2png(1), https://www.amazon.com/gp/feature.html?docId=1000765211, http://sourceforge.net/projects/wa2l-wintools/

 

NOTES

The epub2mobi command uses internally ebook-convert from Calibre and (if conversion with Calibre failed or the Calibre conversion program ebook-convert.exe was not found on the system; see epub2mobi.cfg for details) KindleGen from Amazon to perform the eBook conversion.

Calibre is a powerful e-book management software developed by Kovid Goyal.

For more information about Calibre see: https://calibre-ebook.com/ .

The Calibre software is not bundled with WA2L/WinTools. Download it from: https://calibre-ebook.com/download_portable.

KindleGen is a command line tool which enables publishers to work in an automated environment with a variety of source content including HTML, XHTML or EPUB. KindleGen converts this source content to a single file which supports both KF8 and Mobi formats enabling publishers to create great-looking books that work on all Kindle devices and apps.

KindleGen is officially supported by Amazon to convert files to the Kindle format. Amazon recommends you to use KindleGen to create content that is compatible with all Kindle devices and apps. Files created with third-party software may not work properly on current or future Kindle devices and apps.

For more information about KindleGen see: https://www.amazon.com/gp/feature.html?docId=1000765211.

 

BUGS

On some eBooks the following error condition appears that prevents the ePUB eBook to be converted to MOBI:

  Error(prcgen):E23006: Language not recognized in metadata.
  The dc:Language field is mandatory. Aborting.

This condition was observed in version V2.9 build 1029-0897292 of Amazon kindlegen(Windows).

To nevertheless convert the ePUB e-Book to MOBI consider to install Calibre (see NOTES section) that will be used prior to the Kindlegen fallback to do the conversion.

 

AUTHOR

epub2mobi was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net .

 

COPYRIGHT

Copyright © 2020 Christian Walther

This is free software; see WA2LWinTools/man/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


 

Index

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
OPTIONS
ENVIRONMENT
EXIT STATUS
FILES
EXAMPLES
SEE ALSO
NOTES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 16:32:05 GMT, September 14, 2024