UnCover is a fork of epub-thumbnailer.
The goal of UnCover is to extract book covers from various file formats such as epub.
The original project used a custom install script. To start wtih I only wanted to fork it to use the more conventional setup.py with an entry-point so that users could pip install easily. For fun I started making a few more changes and in the end only about 10% of code is shared with the upstream project.
Note I do not intend to support Gnome before version 3 or Python before version 3.6. Anybody requiring support for older versions should look at epub-thumbnailer.
It is strongly reccomended you use pipx to isolate the dependencies of uncover. This is also the easiest way to get up and running. If you don't have pipx installed follow these instructions
With pipx you can install UnCover with this command:
pipx install --spec git+https://github.com/kajuberdut/uncover.git uncover
You can use UnCover in the command line like this:
uncover <epub_file> <output_file> --size 256
This will look into the epub_file to find its cover, and will save a size px png file as output_file
the --size flag is optional and defaults to 124 pixels.
Nautilus, the file manager from Gnome, supports custom thumbnailers
To register uncover with Nautilus just run:
uncover --register
To unregister you can run:
uncover --unregister
Both commands will likely ask you to enter your sudo password so they can create/remove a file in "/usr/share/thumbnailers". If you would rather not enter your password into that prompt they also provide a shell command you can copy and run seperately.
- Particular thanks to Mariano Simone the author of the parent project
- Indirect thanks to all of Mariono's contributors:
- Marcelo Lira: Improved cover detection by filename
- Pablo Jorge: Added manifest-based cover detection
- Renato Ramonda: Added gnome3 thumbnailer support
- xtrymind: Added tumbler configuration
- A couple of forum