View Full Version : [tool] ExplodeImplodeEpub


xrm0
01-25-2013, 09:56 AM
I've been converting a book to ePub and found myself doing these steps very often:


Uncompress epub
Make modifications
Compress epub
Test it on a device
Repeat 2-4 several times


For the uncompress/compress steps I've first used (un)zip, later changed to ePub Zip/Unzip AppleScript application (http://www.mobileread.com/forums/showthread.php?t=55681) but still wanted to do it with less keystrokes/clicks.

So I've written a small application to do that (ExplodeImplodeEpub). It runs on OS X, Windows and Linux.

You can find the download link and how to use it on http://libresque.com/software

JSWolf
01-25-2013, 12:19 PM
I have not yet had a chance to test this, but it does sound like a very useful tool. Thank you.

DiapDealer
01-25-2013, 04:13 PM
I just use something like 7zip that lets you edit/save files inside the archive directly. No uncompressing/recompressing at all.

I'll definitely check this out, though. Thanks for sharing!

derangedhermit
01-25-2013, 04:29 PM
How does it compare to tweak_epub?

http://www.mobileread.com/forums/showthread.php?t=84692

xrm0
01-25-2013, 07:34 PM
How does it compare to tweak_epub?

Didn't know it. Looks nice.
By reading tweak_epub's docs seems they are pretty similar. tweak_epub have some basic metadata editor, and it gives you a list of the files inside the epub. ExplodeImplodeEpub just presents you the uncompressed folder.
But it seems tweak_epub only runs on Windows, though.

DiapDealer
01-25-2013, 08:13 PM
Didn't know it. Looks nice.
By reading tweak_epub's docs seems they are pretty similar. tweak_epub have some basic metadata editor, and it gives you a list of the files inside the epub. ExplodeImplodeEpub just presents you the uncompressed folder.
But it seems tweak_epub only runs on Windows, though.
The Tweak Book feature (used to be Tweak ePub) of calibre does something very similar: explode ... present you with the uncompressed folder for editing ... rebuild the archive when done. But it's nice to have stand-alone options.

mrmikel
01-25-2013, 08:24 PM
It requires Java, though, which is a security issue. Java is not on my computer, or likely to be. But then I run Windows.

xrm0
01-25-2013, 09:04 PM
The Tweak Book feature (used to be Tweak ePub) of calibre does something very similar: explode ... present you with the uncompressed folder for editing ... rebuild the archive when done. But it's nice to have stand-alone options.

That's the inspiration for ExplodeImplodeEpub! I wanted a small application which did just that.

derangedhermit
01-25-2013, 10:09 PM
It requires Java, though, which is a security issue. Java is not on my computer, or likely to be. But then I run Windows.
Java is not allowed on computers in this house, for that very reason. DHS, in an unusual step, recently issued a warning about Java, triggered by yet another 0-day exploit, saying it would take a minimum of 2 years for Oracle to fix all the security problems.

And that seems strange to me, since the original idea IIRC was to provide a "sandbox" that would provide an environment for running programs in a secure and safe way. I guess that was lost sight of, years ago.

derangedhermit
01-25-2013, 10:12 PM
Didn't know it. Looks nice.
By reading tweak_epub's docs seems they are pretty similar. tweak_epub have some basic metadata editor, and it gives you a list of the files inside the epub. ExplodeImplodeEpub just presents you the uncompressed folder.
But it seems tweak_epub only runs on Windows, though.
It also lets you associate an external editor to be invoked to edit files - default is Notepad, I use Notepad++. It seems to be small, fast, and work well.

My usage so far indicates that it is a useful option for Windows users.

xrm0
01-30-2013, 03:54 PM
There's an update available:

v1.1

Fixed a bug when exploding epubs containing directories entries
__MACOSX/ added to the exclusions list


Download ExplodeImplodeEpub v1.1 (http://libresque.com/software/)

JSWolf
01-30-2013, 08:11 PM
There's an update available:

v1.1

Fixed a bug when exploding epubs containing directories entries
__MACOSX/ added to the exclusions list


Download ExplodeImplodeEpub v1.1 (http://libresque.com/software/)

Don't forget to exclude .ds_store, thumbs.db and iTunesMetadata.plist.

Thanks.

xrm0
01-31-2013, 07:26 AM
Don't forget to exclude .ds_store, thumbs.db and iTunesMetadata.plist.
Thanks.

.DS_Store and Thumbs.db was already on the exclusions list (along with *.swp)

I don't know if iTunesMetadata.plist should be excluded always, maybe someone really wants to keep it on the epub? Perhaps I can add another option, to automatically remove iTunesMetada.plist from the epub (or let the user edit the exclusion list).

JSWolf
01-31-2013, 04:49 PM
.DS_Store and Thumbs.db was already on the exclusions list (along with *.swp)

I don't know if iTunesMetadata.plist should be excluded always, maybe someone really wants to keep it on the epub? Perhaps I can add another option, to automatically remove iTunesMetada.plist from the epub (or let the user edit the exclusion list).

iTunesMetada.plist is not needed. It's put there by iTunes and should be removed whenever found. It causes more issues then it's worth.