What?
epub-thumbnailer is a simple script that tries to find a cover into an epub file and creates a thumbnail for it.
Why?
Because I want my file manager (Nautilus, Thunar, Caja, et al.) to display nice thumnails for my epub ebooks, as it does for pdf files or images, to go from this:
to this:
How to install?
Requirement
install it with pip3 install Pillow (you might need sudo) or with package manager from your distro
Run the installer!
sudo python3 install.py install
Basically, it moves the thumbnailer script to /usr/bin and installs the necessary hooks:
- In gnome2, using a gconf schema (check src/epub-thumbnailer.schemas)
- In gnome3, using a thumbnailer entry (check src/epub.thumbnailer)
After installation, you might need to restart your file manager and remove cached thumbnails (~/.cache/thumbnails)
Stand-alone
This will look into the epub_file to find its cover, and will save a size px png file as output_file
epub-thumbnailer <epub_file> <output_file> <size>
Acknowledgments
- Marcelo Lira: Improved cover detection by filename
- Pablo Jorge: Added manifest-based cover detection
- Renato Ramonda: Added gnome3 thumbnailer support
- Dede Dindin Qudsy: Added tumbler configuration
- Alex Chan: Added Python 3 support
- A couple of forum topics where I learned about the matter