KDE ePub Thumbnailer
Various KDE Extensions
Score 69%
Description:

A KDE thumbnail generator for the ePub file format.
It works with KDE Frameworks 5, for KDE 4 just keep using 1.0 stable release.

Once installed go to Configure Dolphin -> General -> Previews and select ePub documents.

If you have some epub files containing a cover, but not supported by the thumbnailer, please tell me, I'll be glad to test them.

Since 0.9 it doesn't require libepub (ebook-tools).

* fb2? http://kde-apps.org/content/show.php/KDE+fb2+Thumbnailer?content=160180
* chm? http://kde-apps.org/content/show.php/KDE+CHM+Thumbnailer?content=153410

Comments are welcome.
Last changelog:

1.1.9 beta 3 months ago

Just another rewriting for KF5, same features

killerjn

18 days ago

thanks tuve que instalar estas librerias adicionales
libkf5archive-dev
libqt5xmlpatterns5-dev

ya puedo ver las miniaturas de los epub excelente trabajo

Report

ARTO222

1 year ago

Thanks for the terrific job.
Installed following the Installation from source (KF5) instructions on your github page on manjaro 16.06.1 and everything works.

However, on both on linux mint 18 as well as kubuntu 16.04 terminal output is:
--------------------
mint@mint ~/bin/kde-thumbnailer-epub-1.1/build $ cmake -DKDE_INSTALL_USE_QT_SYS_PATHS=ON -DCMAKE_INSTALL_PREFIX=`kf5-config --prefix` ..
-- The C compiler identification is GNU 5.4.0
-- The CXX compiler identification is GNU 5.4.0
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
CMake Error at CMakeLists.txt:5 (find_package):
Could not find a package configuration file provided by "ECM" (requested
version 1.0.0) with any of the following names:

ECMConfig.cmake
ecm-config.cmake

Add the installation prefix of "ECM" to CMAKE_PREFIX_PATH or set "ECM_DIR"
to a directory containing one of the above files. If "ECM" provides a
separate development package or SDK, be sure it has been installed.


-- Configuring incomplete, errors occurred!
See also "/home/mint/bin/kde-thumbnailer-epub-1.1/build/CMakeFiles/CMakeOutput.log".
------------
Would much appreciate any suggestions on this as well as the build instructions for the .mobi thumbnailer you mentioned in a previous post.

Thanks again.

Report

ARTO222

1 year ago

Same issue on a fresh on manjaro.

Report

C

caig

1 year ago

Hi, sorry for the late answer, the website didn't send me any notification :/

* Compile issue:
Is the package "extra-cmake-modules" installed?

* Mobi thumbnailer:
Being an official KDE project, don't your distros really offer a dedicated package, something like "kdegraphics-mobipocket"?

Report

FallenX

1 year ago

Thank you for update to plasma5.

Would you like to update chm thumbnailer to plasma 5?

Report

C

caig

1 year ago

Yes, I plan to port the chm thumbnailer too.

Report

sosonok

2 years ago

Hi, caig.

What about a Plasma version now that KDE 4 is unmanteined? I can't live without it! ;-)

Report

C

caig

2 years ago

Hi,
yes, sure. I was waiting for Dolphin official kf5 release (and a bit of free time).

Report

sosonok

2 years ago

Nice to hear, caig. Thanks for your time.

Report

TheBlackCat

3 years ago

I notice you are building this on openSUSE buildservice. Would it be possible to submit it to KDE:Extra so other openSUSE users can install it more easily?

Report

C

caig

3 years ago

Interesting suggestion, I'll investigate about this possibility. Thanks.

Report

omiliya

4 years ago

Fine work! Thanks for that.
I'd like to see support for format FB2. This format is very popular in russia, about a half of my ebooks colection are in fb2.

If you interested in this format here's the specification:
http://www.gribuser.ru/xml/fictionbook/index.html.en

Report

C

caig

4 years ago

Thanks!
Last year I thought about doing a fb2 thumbnailer, but I didn't understand it is an important and currently used format. Thanks for the information!
At a first glance it seems a simple file format, even for a non-expert like me ... doing some tests :)

Is it common to have and use directly .fb2.zip files?

Report

omiliya

4 years ago

Thanks for your answer.
Format is simple xml with cover image encoded in base64.
Both fb2 and fb2.zip are used widely in Russia and ex-USSR countries.

Report

C

caig

4 years ago

A first version (no fb2.zip support) is ready for test :)

Report

HardinComp

4 years ago

Should I be getting preview thumbs for .mobi files?

Report

C

caig

4 years ago

No, just epub, for mobi files KDE offers a thumbnailer

mobipocket: https://projects.kde.org/projects/kde/kdegraphics/kdegraphics-mobipocket/repository/revisions/master/show/thumbnailers
Bye!

Report

HardinComp

4 years ago

Thanks! I didn't see that when I was searching earlier. I love your epub thumbnailer. Good job on it!

Report

swissball

4 years ago

Hello caig,

thanks for your work.
What can I change, to get a thumb displayed.
I did the one-click install and started dolphin again, but no thumb is displayed (also not for pdf).
>Configure Dolphin -> General -> Previews and select ePub documents.<
I cannot find a field "epub" in any of dolphins menues.

I use:
german
openSuse 12.2; Linux 3.4.11-2.16-desktop x86_64
KDE: 4.8.5 (4.8.5)
dolphin Version 2
in YaST2:
libepub is not there but
libepub0
libepub-devel is not installed
okular works fine with mobi, pdf, djvu and epub

thank you
greetings
micca

Report

C

caig

4 years ago

Hello,
thank you for reporting the issue :)

If the package is successfully installed, the option should be displayed.
The configuration option is a bit hidden in the Dolphin default interface.
Try to use the button on the right side of the toolbar http://paste.opensuse.org/e097a2b4
It should list the "Configure Dolphin" item to open the configuration
dialog and to find the option (General -> Previews and select ePub documents).

Please tell me again if you have some troubles.

Bye!

----
About the PDF thumbnails issue:
check if you have the "kdegraphics-thumbnailers" package installed and the
configuration option selected in Dolphin.

Report

sosonok

5 years ago

Well, I hope I've found something relevant.

When id for the cover item in content.opf is exactly "cover", thumbnail is produced. But in many epubs the id is the whole file name, extension included:

<item href="Images/cover.jpeg" id="cover.jpeg" media-type="image/jpeg" />

These ones aren't thumbnailed.

Report

sosonok

5 years ago

I can see the same covers I saw in the previous version. Nothing more. They have in common they are from epubs generated by Calibre, they use svg to scale covers and they use preserveAspectRatio="none" attribute.

This makes less than 1% of my epubs (none of them produced by me).

Report

C

caig

5 years ago

Do you mean less of 1% of your epubs show a cover? Very bad result :(
In my case I have a 89% of success, 5% more than 0.1 release.
The plugin in first instance searches for a guide element like this:

<guide>
<reference type="cover" title="Cover" href="Text/Section0001.xhtml"/>
</guide>

(type="cover")

If not, as the 0.1 did, searches for the first html/xml file (usually it contains the cover) and parses the file searching for <img> or <image>.

Your suggestion in the other message make me thinking about another way to retrieve covers I can add. I'll study and try it. One of your not working epubs is available for free somewhere? It can be useful to understand. Thank you :)

Report

sosonok

5 years ago

I forgot to mention most of my epubs have a peculiarity: cover image is inside a header (the first one). Anyway a couple of extra examples: the second one was ok, now I remove preserveAspectRatio="none" and I can't see cover anymore in Dolphin.

http://uploadmirrors.com/download/0PGVCQKU/FederidoGarciaLorca.LaCasaDeBernardaA1.1_0.epub

http://uploadmirrors.com/download/0I2PA6U4/Novelas_ejemplares_-_Cervantes.epub

http://uploadmirrors.com/download/PANVOXNG/Curzio_Malaparte_-_La_piel.epub

Report

C

caig

5 years ago

Very interesting...I see them:
http://i.imgur.com/SYirZ.png
They are supported with the first strategy (searching for something like):

<guide>
<reference href="Text/titlepage.xhtml" title="Cover" type="cover"/>
</guide>

Report

1.1.9 beta 3 months ago

Just another rewriting for KF5, same features

1 year ago

1.1
-----
Stable KF5 release

1.0.9 beta
-----
KDE Frameworks 5 porting

1.0
-----
Stable KDE 4 release

0.9 beta (nolibepub branch)
-----
Complete rewrite:
* It requires no more libepub.
* Increased supported ePub files.

0.3.1
-----
* Added another strategy to find the cover, currently shaped on Sigil (by dliw) [0.3]
* German translation added (by dliw) [0.3]
* Better memory management
* Minor code improvements

0.2
-----
* Increased supported ePub files:
- a new strategy to retrieve the cover from standard compliant ePub files;
- the "old" strategy now is the second option;
- a little improvement to increase the possibility of a successful result.
* Some minor improvements.
* Simplified Chinese (zh_CN) translation added. Thanks to nihui.

0.1
-----
first release

File (click to download) Version Description Filetype Packagetype License Downloads Date Filesize OCS-Install DL
Details
version
1.1.9 beta
updated Jun 30 2017
added May 29 2012
downloads today
0
page views today 2