[GUI Plugin] EpubSplit

[JimmXinu]

My question: My device is Kindle so the vast majority of my files are mobi and azw (and those variations). Will epubsplit work on those files and if so, do I need to convert to epub, split then reconvert back to mobi?

As others have said, converting mobi/azw to epub, splitting and converting back to mobi/azw should work.

But I don't know how well. Conversion changes the contents to some degree. How much and how well depends on the source book and your conversion settings, mostly.

I would not trust a convert-split-convert-back process blindly. I'd try it for a book or two and see how it works. And even after that, you should examine the contents of all the split books you make, not just assume they worked as intended..

Sorry I can't give you a more definitive answer, but I don't think there is one.

[JSWolf]

Thanks for explaining a bit here.

I pick #2 above. But I would have just converted using the conversion plug-ins as I normally do. Is there a difference or an advantage to using the KindleUnpack?

By using KindleUnpack to shift (not convert) the code, you don't get converted code. You get the same code that's in the KF8. You should load the ePub in Sigil, check for errors and fix any errors found as there will be errors. But once that's done, you have an ePub that matched the KF8.

[JimmXinu]

Version 1.2.7 - 15 Mar 2012

Command Line Interface(CLI)

Starting with calibre v0.9.23, calibre offers a command-line interface (CLI) for calling plugins.

This plugin supports that option and allows the user to call the plugin's basic functionality from outside calibre without having to install Python or get the plugin's files separately.

Details:

Usage: calibre-debug.exe --run-plugin EpubSplit -- [options] <input epub> [line numbers...]

Giving an epub without line numbers will return a list of line numbers: the
possible split points in the input file. Calling with line numbers will
generate an epub with each of the "lines" given included.

Options:
  -h, --help            show this help message and exit
  -o OUTPUT, --output=OUTPUT
                        Set OUTPUT file, Default: split.epub
  -t TITLE, --title=TITLE
                        Use TITLE as the metadata title.  Default: '<original
                        epub title> Split'
  -d DESC, --description=DESC
                        Use DESC as the metadata description.  Default: 'Split
                        from <epub title> by <author>'.
  -a AUTHOR, --author=AUTHOR
                        Use AUTHOR as a metadata author, multiple authors may
                        be given, Default: <All authors from original epub>
  -g TAG, --tag=TAG     Include TAG as dc:subject tag, multiple tags may be
                        given, Default: None
  -l LANG, --language=LANG
                        Include LANG as dc:language tag, multiple languages
                        may be given, Default: en
  -c COVER, --cover=COVER
                        Path to a jpg to use as cover image.

[sergo]

calibre, version 0.9.23
ERROR: Install Plugin Failed: A problem occurred while installing this plugin. This plugin will now be uninstalled. Please post the error message in details below into the forum thread for this plugin and restart Calibre.

Traceback (most recent call last):
File "site-packages\calibre\gui2\dialogs\plugin_updater.py", line 728, in _install_clicked
File "site-packages\calibre\customize\ui.py", line 361, in add_plugin
File "site-packages\calibre\customize\ui.py", line 53, in load_plugin
File "site-packages\calibre\customize\zipplugin.py", line 167, in load
File "site-packages\calibre\customize\zipplugin.py", line 150, in load_module
File "calibre_plugins.epubsplit.__init__", line 14, in <module>
ImportError: cannot import name main

[jmatute]

Hi,

I received this error when updating the plugin:

calibre, version 0.9.23
ERROR: Fallo en la instalación del complemento: Ha ocurrido un error al instalar este complemento y a continuación se desinstalará. Por favor, publique el mensaje de error que aparece en los detalles de más abajo en la conversación del foro para este complemento y reinicie calibre.

Traceback (most recent call last):
File "site-packages\calibre\gui2\dialogs\plugin_updater.py", line 728, in _install_clicked
File "site-packages\calibre\customize\ui.py", line 361, in add_plugin
File "site-packages\calibre\customize\ui.py", line 53, in load_plugin
File "site-packages\calibre\customize\zipplugin.py", line 167, in load
File "site-packages\calibre\customize\zipplugin.py", line 150, in load_module
File "calibre_plugins.epubsplit.__init__", line 14, in <module>
ImportError: cannot import name main

Thanks in advance,
Jose Luis.

[kbaerwald]

Same problem here with update:

calibre, version 0.9.23
FEHLER: Installation des Plugins fehlgeschlagen: Während der Installation der Erweiterung ist ein Problem aufgetreten. Dieses Plugin wird nun entfernt. Bitte veröffentlichen Sie die Fehlermeldung im Detail unten in den Foren-Thread dieser Erweiterung und starten Sie Calibre neu.

Traceback (most recent call last):
File "site-packages\calibre\gui2\dialogs\plugin_updater.py", line 728, in _install_clicked
File "site-packages\calibre\customize\ui.py", line 361, in add_plugin
File "site-packages\calibre\customize\ui.py", line 53, in load_plugin
File "site-packages\calibre\customize\zipplugin.py", line 167, in load
File "site-packages\calibre\customize\zipplugin.py", line 150, in load_module
File "calibre_plugins.epubsplit.__init__", line 14, in <module>
ImportError: cannot import name main

Thanks for notice

Klaus

[Gunnerp245]

Ditto!

[JimmXinu]

Version 1.2.8 - 16 Mar 2012

Move CLI main import into cli_main. Caused problems for some users on install. I haven't been able to reproduce the problem, but this should fix it.

[loximuthal]

Originally Posted by JimmXinu

Move CLI main import into cli_main. Caused problems for some users on install. I haven't been able to reproduce the problem, but this should fix it.

I had the same problem, but with the update it has gone away. Thanks!

[DavidJC]

Plugin has vanished with the 0.9.29 calibre updated. Kovid suggests that the plugin needs updating.

[JimmXinu]

Version 1.2.9 - 03 May 2013

• Fix for a changed an internal name in calibre in 0.9.29.

[Feather_Qwill]

Great plugin! I just downloaded this and used it successfully for several ebooks, however I've run into a problem.

I have an omnibus which doesn't have any section markings when I try to split it. I think it's because it's one that I converted from a different file type a few years ago.

How can I "mark" sections off so that I can split them?

[JimmXinu]

@Feather_Qwill - You can't with EpubSplit directly. It only recognizes Table of Contents and files inside the epub as points to split from.

You could use a different program (Sigil is one I use frequently) to add ToC and then split.

[kbaerwald]

@Feather_Qwill

Try the ToC plugin before EpubSplit! If there are headings or any file segmentations in the book you can generate a ToC on the fly. Then apply EpubSplit.

If this does not work - follow the advice of JimmXinu.

Klaus

[happysadhu]

Hello,
First off. Thanks for creating such an awesome plugin--very handy!

Overall, it works great. However, every time I finish selecting the sections to split off and edit the meta edit, the Calibre hangs while it is processing the new epub. The dialog box "Select Sections to Split Off" says "not responding". After a few seconds (e.g., 20 seconds), Calibre and the epubsplit dialog box returns to functioning normally. Is this the typical behavior of the plugin?