marianosimone / epub-thumbnailer

Script to extract the cover of an epub book and create a thumbnail for it

👋🏽 I’m Mariano Simone, and this is a short intro to me. I hope you’ll find it useful if we need to work together. This is a stripped-down version of what I'd share internally at my company (as I usually customize it to refer to a particular team, include tooling, etc.)

⚙️ How I work

I usually like to have one big project and multiple smaller things going on at the same time, so I can take a break and shuffle things around if/when I get bored.

Things you’ll see me doing:

• Keeping track of what needs to be done and making sure that we are all on the same page.
• Asking “Why” and “Are we sure we want to do this?” many (sometimes five) times.
• Doing small steps towards the goal: I like to keep changes small, easy to explain and undo.
• Philosophizing a lot about the perfect way to do something, and then choosing what’s the best, practical way to do it.
• Relentlessly downsizing (be it code, documentation, processes, slack channels, etc.)
• Keeping an eye on any changes to our codebase, trying to keep readability, code quality and good typedness as high as possible.

💬 How I like to communicate

I don’t have a strong preference on Slack (or any other IM platform) over Email, but I’m pretty principled about:

• Don’t ask to ask, just ask, and ask useful questions.
• Don’t invite me to a meeting without a clear agenda. If I need context, please include it (or links to relevant documents) in the invitation itself.
• How to ask good questions.
• I love Jira/Trello and Dropbox Paper to keep track of things to do… I can deal with Google Docs and Google Sheets, but I’d rather not.
• I turn off my notifications after hours 💤/when I want to relax 🏝… so feel free to ping me at any time without worrying about bothering me. I'll get back to you when I'm available again.
• In case you haven’t noticed in this document… I make extensive use of emoji 🎉.

🎲 Random things about me

• 🇦🇷 I’m originally from Argentina (but no, I don’t like fútbol - soccer -, nor beef… so I had to leave the country).
• ⛰ I live in Aurora, CO. Since I moved to the US, I’ve always lived in “smaller” siblings of well known cities: Brooklyn (NYC), Berkeley (SF) and Aurora (Denver). - 🍻🧀 I enjoy (and sometimes make my own) beer and cheese.
• 🎵 I love music, and my taste is pretty eclectic. Pink Floyd, Led Zeppelin, and Bob Marley are some of my favorites… but you will also see me listening to Yo-Yo Ma, System of a Down, Aziza Mustafa Zadeh, Miles Davis or Hiromi Uehara any other day.

If I’m not working, I’m probably:

• 📚 Reading books, or random internet things (see my Pocket profile).
• 🧗🏽‍♂️ Climbing (mostly bouldering).
• 🍵 Drinking tea.
• 🍳 Cooking (see some of my recipes).
• 🗺 Traveling (see the places I’ve been to).

In previous lives, you might have found me:

• ☯️ Practicing kung fu (I still do from time to time, but not much)
• 🎸 Playing an instrument (guitar, laúd - a Spanish lute -, or trumpet)
• ⛵ Sailing
• 🏹 Shooting a longbow

💎 Strong beliefs

Most of these are serious… some may look like they are not, but they are.

• “Done” is better than “Perfect”… but we should know what “Perfect” looks like, and explicitly decide not to go for that.
• There’s one, and only one, way to write down dates: YYYY-MM-DD. (I’m not alone… ISO 8601 is praised by a lot of people).
• There’s no need to discuss tabs vs spaces. All sane people use spaces, and I wouldn’t discuss with insane people, so 🤷🏽‍♂️.

epub-thumbnailer's Issues

KDE support?

How can I get this to work in KDE Dolphin file manager?

Moksha window manager

Hello,
I was not able to install epub-thumbnailer on my Moksha desktop.
Moksha is a fork of enlightenment, and is originally found in Bodhi Linux.
However, I have it installed on ubuntu. I use the Caja file manager.
Here is the long list of "ps -A"

PID TTY TIME CMD
1 ? 00:00:11 systemd
2 ? 00:00:00 kthreadd
4 ? 00:00:00 kworker/0:0H
6 ? 00:00:00 mm_percpu_wq
7 ? 00:00:00 ksoftirqd/0
8 ? 00:07:50 rcu_preempt
9 ? 00:00:00 rcu_sched
10 ? 00:00:00 rcu_bh
11 ? 00:03:05 rcuop/0
12 ? 00:00:00 rcuos/0
13 ? 00:00:00 rcuob/0
14 ? 00:00:00 rcuc/0
15 ? 00:00:00 rcub/0
16 ? 00:00:00 migration/0
17 ? 00:00:03 watchdog/0
18 ? 00:00:00 cpuhp/0
19 ? 00:00:00 cpuhp/1
20 ? 00:00:05 watchdog/1
21 ? 00:00:00 migration/1
22 ? 00:00:00 rcuc/1
23 ? 00:00:00 ksoftirqd/1
25 ? 00:00:00 kworker/1:0H
26 ? 00:00:08 rcuop/1
27 ? 00:00:00 rcuos/1
28 ? 00:00:00 rcuob/1
29 ? 00:00:00 cpuhp/2
30 ? 00:00:01 watchdog/2
31 ? 00:00:00 migration/2
32 ? 00:00:00 rcuc/2
33 ? 00:00:00 ksoftirqd/2
35 ? 00:00:00 kworker/2:0H
36 ? 00:03:22 rcuop/2
37 ? 00:00:00 rcuos/2
38 ? 00:00:00 rcuob/2
39 ? 00:00:00 cpuhp/3
40 ? 00:00:07 watchdog/3
41 ? 00:00:00 migration/3
42 ? 00:00:00 rcuc/3
43 ? 00:00:00 ksoftirqd/3
45 ? 00:00:00 kworker/3:0H
46 ? 00:00:07 rcuop/3
47 ? 00:00:00 rcuos/3
48 ? 00:00:00 rcuob/3
49 ? 00:00:00 kdevtmpfs
50 ? 00:00:00 netns
54 ? 00:00:00 khungtaskd
55 ? 00:00:00 oom_reaper
56 ? 00:00:00 writeback
57 ? 00:00:00 kcompactd0
58 ? 00:00:00 ksmd
59 ? 00:00:03 khugepaged
60 ? 00:00:00 crypto
61 ? 00:00:00 kintegrityd
62 ? 00:00:00 bioset
63 ? 00:00:00 kblockd
65 ? 00:00:00 ata_sff
66 ? 00:00:00 md
67 ? 00:00:00 edac-poller
68 ? 00:00:00 devfreq_wq
69 ? 00:00:00 watchdogd
72 ? 00:00:00 kauditd
73 ? 00:00:00 kswapd0
74 ? 00:00:00 bioset
75 ? 00:00:00 ecryptfs-kthrea
118 ? 00:00:00 kthrotld
119 ? 00:00:00 acpi_thermal_pm
120 ? 00:00:00 bioset
121 ? 00:00:00 bioset
122 ? 00:00:00 bioset
123 ? 00:00:00 bioset
124 ? 00:00:00 bioset
125 ? 00:00:00 bioset
126 ? 00:00:00 bioset
127 ? 00:00:00 bioset
135 ? 00:00:00 ipv6_addrconf
158 ? 00:00:00 charger_manager
207 ? 00:00:00 scsi_eh_0
208 ? 00:00:00 scsi_tmf_0
209 ? 00:00:00 scsi_eh_1
210 ? 00:00:00 scsi_tmf_1
211 ? 00:00:00 scsi_eh_2
212 ? 00:00:00 scsi_tmf_2
213 ? 00:00:00 scsi_eh_3
214 ? 00:00:00 scsi_tmf_3
215 ? 00:00:00 scsi_eh_4
216 ? 00:00:00 scsi_tmf_4
217 ? 00:00:00 scsi_eh_5
218 ? 00:00:00 scsi_tmf_5
224 ? 00:00:00 bioset
225 ? 00:00:00 bioset
227 ? 00:00:00 kworker/1:1H
228 ? 00:00:00 kworker/0:1H
230 ? 00:00:01 kworker/2:1H
234 ? 00:00:00 i915/signal:0
235 ? 00:00:00 i915/signal:1
236 ? 00:00:00 i915/signal:2
304 ? 00:00:00 kworker/3:1H
328 ? 00:00:11 jbd2/sda1-8
329 ? 00:00:00 ext4-rsv-conver
375 ? 00:00:07 systemd-journal
413 ? 00:00:00 systemd-udevd
588 ? 00:00:00 irq/27-mei_me
598 ? 00:00:00 kmemstick
878 ? 00:00:00 kworker/u17:0
879 ? 00:00:00 hci0
880 ? 00:00:00 hci0
881 ? 00:00:00 kworker/u17:1
888 ? 00:00:21 jbd2/sda2-8
889 ? 00:00:00 ext4-rsv-conver
1204 ? 00:00:00 cfg80211
1219 ? 00:00:00 rpcbind
1223 ? 00:00:07 avahi-daemon
1224 ? 00:00:00 avahi-dnsconfd
1225 ? 00:00:04 rsyslogd
1228 ? 00:00:00 smartd
1230 ? 00:00:00 cron
1232 ? 00:00:23 dbus-daemon
1239 ? 00:00:00 systemd-logind
1240 ? 00:00:01 ofonod
1242 ? 00:00:00 cupsd
1243 ? 00:00:00 bluetoothd
1244 ? 00:00:15 acpid
1245 ? 00:00:22 thermald
1247 ? 00:00:21 NetworkManager
1248 ? 00:00:04 accounts-daemon
1255 ? 00:00:09 snapd
1323 ? 00:00:01 atop
1356 ? 00:00:00 avahi-daemon
1362 ? 00:00:00 krfcommd
1367 ? 00:00:04 cups-browsed
1387 ? 00:00:03 irqbalance
1428 ? 00:00:00 lightdm
1471 ? 00:00:07 polkitd
1481 ? 00:00:00 colord
1487 ? 00:00:33 vnstatd
1489 ? 00:00:00 sshd
1496 ? 00:00:00 sh
1501 ? 00:05:21 boinc
1517 tty7 00:12:15 Xorg
1530 ? 00:00:05 wpa_supplicant
1780 ? 00:00:00 lightdm
1784 ? 00:00:00 whoopsie
1821 tty1 00:00:00 agetty
1836 ? 00:00:10 ntpd
1847 ? 00:00:45 tor
1857 ? 00:00:02 apache2
1860 ? 00:00:33 apache2
1861 ? 00:00:31 apache2
1966 ? 00:01:11 collectl
2487 ? 00:00:00 systemd
2488 ? 00:00:00 (sd-pam)
2495 ? 00:00:05 enlightenment_s
2570 ? 00:00:00 ssh-agent
2573 ? 00:00:00 dbus-launch
2574 ? 00:00:01 dbus-daemon
2584 ? 00:00:26 ibus-daemon
2585 ? 00:02:05 enlightenment
2589 ? 00:00:00 gvfsd
2594 ? 00:00:00 gvfsd-fuse
2603 ? 00:00:00 ibus-dconf
2604 ? 00:00:06 ibus-ui-gtk3
2606 ? 00:00:03 ibus-x11
2608 ? 00:00:00 at-spi-bus-laun
2613 ? 00:00:01 dbus-daemon
2615 ? 00:00:25 at-spi2-registr
2627 ? 00:00:02 efreetd
2663 ? 00:00:08 ibus-engine-sim
2666 ? 00:00:04 enlightenment_f
2675 ? 00:00:05 udisks-daemon
2676 ? 00:00:00 udisks-daemon
6174 ? 00:01:03 qterminal
6181 pts/0 00:00:00 zsh
6251 ? 00:00:42 caja
6257 ? 00:00:00 gvfs-udisks2-vo
6260 ? 00:00:03 udisksd
6268 ? 00:00:00 gvfs-mtp-volume
6273 ? 00:00:00 gvfs-afc-volume
6279 ? 00:00:00 gvfs-goa-volume
6283 ? 00:00:00 goa-daemon
6291 ? 00:00:00 goa-identity-se
6293 ? 00:00:07 mission-control
6296 ? 00:00:00 gvfs-gphoto2-vo
6308 ? 00:00:00 gvfsd-trash
6324 ? 00:00:00 gvfsd-metadata
6326 ? 00:00:00 dconf-service
6346 ? 00:14:40 chromium-browse
6380 ? 00:00:00 chromium-browse
6382 ? 00:00:00 chromium-browse
6411 ? 00:07:28 chromium-browse
6432 ? 00:00:00 chromium-browse
6638 ? 00:00:07 pulseaudio
6752 ? 00:00:03 chromium-browse
6765 ? 00:00:06 chromium-browse
6867 ? 00:01:34 chromium-browse
7689 ? 00:01:10 chromium-browse
11050 ? 00:00:00 gconfd-2
11062 ? 00:00:00 kdeinit4
11065 ? 00:00:00 klauncher
11067 ? 00:00:02 kded4
11615 ? 00:00:17 kworker/2:2
12641 ? 00:00:13 chromium-browse
12760 ? 00:00:11 chromium-browse
13016 ? 00:00:00 kworker/1:0
13441 ? 00:00:00 mate-settings-d
13813 ? 00:00:00 gvfsd-network
13831 ? 00:00:01 gvfsd-dnssd
14751 ? 00:00:28 kworker/u16:3
23200 ? 00:00:04 kworker/0:1
23616 ? 00:00:12 kworker/u16:1
24102 ? 00:00:01 kworker/3:1
24235 ? 00:00:07 kworker/u16:0
24282 ? 00:00:00 dhclient
24356 ? 00:00:08 kworker/u16:2
24482 ? 00:00:01 kworker/3:0
24530 ? 00:00:00 kworker/2:1
24540 ? 00:00:00 kworker/0:0
24855 ? 00:00:00 kworker/1:2
24946 ? 00:00:08 audacious
25100 ? 00:00:00 kworker/2:0
25117 ? 00:00:00 efl_net_proxy_h
25129 pts/0 00:00:00 ps

Thumbnailer on Mint 17.1 and 18 Cinnamon

Hi,
sorry to bother you with this. I'm happily using epub-thumbnailer with Linux Mint 17.1/Cinnamon installed on an older notebook some time ago. Unfortunately, I am not able to make it work on a different computer, running Linux Mint 18 / Cinnamon 3.0.7.

On Mint 17.1 / Cinnamon 2.4.8, using the command you asked for in an older post, I get:
js@js-X201 ~ $ ps -A | egrep -i "mate|gnome|xfce4|unity"
1711 ? 00:00:00 gnome-keyring-d
2256 ? 00:00:00 polkit-gnome-au
4256 ? 00:00:00 gnome-terminal
4262 ? 00:00:00 gnome-pty-helpe

js@js-X201 ~ $ gnome-shell --version
GNOME Shell 3.10.4

When installing on Mint 18 I first got "sh: 1: gnome-shell: not found". After installing Gnome shell etc., installation was finished sucessfully and I can manually extract "cover.png" via "epub-thumbnailer title.epub cover.png 128". However, no thumbnails are shown for the epub-files. I cleared .cache and restarted Nemo.

On Mint 18 / Cinnamon 3.0.7 I get:
js@js-MSI1 ~ $ ps -A | egrep -i "mate|gnome|xfce4|unity"
2021 ? 00:00:00 gnome-keyring-d
2351 ? 00:00:00 polkit-gnome-au
7013 ? 00:00:06 gnome-terminal-

js@js-MSI1 ~ $ gnome-shell --version
GNOME Shell 3.18.5

You have an idea what could be the issue here?
(Sorry, I lack knowledge of Linux and neither do I understand your script...I'm just a user....)
Thanks!

Detect gnome version when gnome-session is not available via gnome-shell

Getting a traceback on installation:

Installing epub-thumbnailer to /usr/bin/ ...
OK
Traceback (most recent call last):
File "install.py", line 144, in 
commandsargs.action
File "install.py", line 92, in install
environment = check_desktop_env()
File "install.py", line 79, in check_desktop_env
return VERSION_GUSSERS.get(desktop_environment, lambda: None)()
File "install.py", line 60, in gnome_shell_version
major_version = version[1][0]
IndexError: list index out of range

Running from terminal causes another traceback. Maybe related?

$epub-thumbnailer
Traceback (most recent call last):
  File "/usr/bin/epub-thumbnailer", line 24, in <module>
    from StringIO import StringIO
ImportError: No module named 'StringIO'

Running Arch Linux (4.2.5-1-ARCH) with Gnome Version 3.18.2. Anything else you want to know just ask. Thanks. :) Looking forward to getting thumbnails to my epubs. :)

Instructions for Pillow in readme

Installing Pillow in my case needed sudo, in Manjaro xfce.

Not working on linux Mint 17.3 with XFCE

Hi, I installed the thumbnailer but even after logging out, none of my epubs would show the thumbnail. I am using Linux Mint 17.3, which is based in Ubuntu 14.04, and with the XFCE 4.12 desktop environment. Also, I saw the issue below, but preferred to make my own, just in case the problems are different. So, I will already answer some of your questions

1. Yes, the installation went successfully
2. Yes, the command does extracts the cover
3. (Not so sure if it will help since I am using XFCE, but..) gnome-session --version = gnome-session 3.9.90
4. That command didn't work, just threw a bunch of command not found (Seems like you forgot the quotes, correcting it gives this output):
   17 ? 00:00:00 kdevtmpfs
   1586 ? 00:00:00 xfce4-session
   1598 ? 00:00:18 xfce4-panel
   1611 ? 00:00:00 polkit-gnome-au
   1637 ? 00:00:02 xfce4-power-man
   1645 ? 00:00:00 xfce4-volumed
   7049 ? 00:00:01 xfce4-notifyd
   8445 ? 00:00:00 gnome-terminal
   8449 ? 00:00:00 gnome-pty-helpe
5. I am using both nemo and Thunar and both of them the thumbnail doesn't appear.

By the way, I think that I might have lost pdf thumbnails, not so sure if your program can cause that, but thought it might be good to mention.

Error running the script: python not found, even though it is installed

Hi,

I am not an expert Gnu/Linux user, so I may have done something wrong or missed something obvious but since I got the same error on my two machines and got it to work using the same solution I thought I might not be alone in having this issue.

Following the installation instructions, I got an error message when trying to run the install script using the sudo python install.py install command (on two Debian 11/Xfce PC). The shell was telling there was no python installed: bash: python: command not found. I tried to (re)install it using apt, but it told me it was already installed.

Replacing 'python' by 'python3' (sudo python3 install.py install), the installation ran as as expected and everything is working great. Thank you so much for writing this, It's great to be able to display ebooks cover in the file manager :)

Gnome-shell Window manager warnings in Ubuntu Cosmic

epub-thumbnailer (1.0) fails to work on latest Ubuntu. The following logs are seen in syslog:

Feb 13 14:54:56 Think org.gnome.Shell.desktop[3587]: Window manager warning: 0x1c00016 (epub-thumb) appears to be one of the offending windows with a timestamp of 9172827. Working around... Feb 13 14:54:57 Think org.gnome.Shell.desktop[3587]: Window manager warning: 0x1c00016 (epub-thumb) appears to be one of the offending windows with a timestamp of 9172861. Working around...

$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description: Ubuntu 18.10
Release: 18.10
Codename: cosmic

$ python --version
Python 2.7.15+

$ nautilus --version
GNOME nautilus 3.26.4

Can I tweak it to make better quality thumbs?

FEATURE REQ or how-to-inquiry: I've got Caja set up to show thumbnails HUGE, but blowing these up doesn't help because they're so compressed. I tried unzipping an epub, extracting a copy of the cover jpg, converting it to a png with imagemagick's convert, and copying the png over over the corresponding one in ~/.cache/thumbnails/normal/ (which I presume this created) and that looked great. A config file where I could opt to bypass compression and just convert the jpg to a png would be great. I'm working on doing that with a bash script but if there is a setting or easy hack to tweak this to do that, I don't want to reinvent the wheel. So any hint on what I might change to accomplish that would be appreciated.

Solution works with Ubuntu Unity 16.04

I ran the install script and got an error that Distribution could not be detected so epub-thumbnailer could be used to manually generate thumbnails.

Looking at the script I noticed that for Gnome 3 or xfce4 the script would just copy epub.thumbnailer from the src directory to /usr/share/thumbnailers/, so I did just that and hit refresh on Nautilus. Thumbnails are generated normally.

Maybe you could just add a check for Unity (or maybe just Nautilus in general?) and install it there.

Make installable via pipx?

Thank you for creating this project! Do you think you could make it installable via pipx?
This would make it much easier to integrate your project into installer/bootstrapping-scripts...

Support for GVFS

At the moment it's not compatible with gvfs e.g. smb://. (Previews everywhere enabled in the Caja-Settings)

I've added to my .py:
import gio

if input_file.find('://') >= -1:
f = gio.File(input_file)
input_file = f.get_path()

and changed my .thumbnailer:
Exec=/usr/bin/epub-thumbnailer %i %o %s
to
Exec=/usr/bin/epub-thumbnailer %u %o %s

But I think there are better solutions...

[Ubuntu 13.10] No preview in nautilus

Hi,

after installing the epub-thumbailer nautilus doesn't show any covers.

Installation:

Checking dependencies ...

Required dependencies:
Python Imaging Library ....... OK

Installing epub-thumbnailer to /usr/bin/ ...

Installed /usr/bin/epub-thumbnailer
Installed /usr/share/thumbnailers/epub.thumbnailer

Installed the thumbnailer hook in /usr/share/thumbnailers/
You might have to restart your file manager for the thumbnailer to be activated.

Tried to use the command in console but I don't know what should happen:

/usr/bin/epub-thumbnailer /home/XX/Downloads/my.epub cover.png 128

No output.

Any hint would be appreciated!

Best regards from Germany
Sascha

Thumnbailer not working in Ubuntu Gnome 16.04

Hi there,

although I followed your instrucitions precisely the epub thumbnailer is not working on my machine. Nautilus still shows the general icons.

I'm running Ubuntu Gnome 16.04.

Hope you can help me with this matter,
thanks, Don

License

Hi,
Could you please consider adding a license to this software ?

Thanks for the project !

Ubuntu 21.10

Please add support for Ubuntu 21.10 in order to get the cover automatically

Consider adding cover creation when not found

Think about adding something like https://github.com/mgiraldo/imagecoverp5tint

Thumbnails not being generated by Thunar

It might have to do with the installation process

Reported originally as #12

Doesn't work with Muffin window manager and Nemo file manager

In Linux Mint 19.2 I get:
sh: 1: gnome-shell: not found

It would be nice to have epub thumbnails, but I'm not exited about installing another shell with it's possible problems just for that reason. I'm reporting this anyway, in case it might be useful to developers.

File manager: Nemo
Window manager: Muffin
Result of the command "ps -A" (tried to attach it as a text file, but the file wasn't accepted by this report system):

PID TTY TIME CMD
1 ? 00:00:02 systemd
2 ? 00:00:00 kthreadd
4 ? 00:00:00 kworker/0:0H
6 ? 00:00:00 mm_percpu_wq
7 ? 00:00:04 ksoftirqd/0
8 ? 00:00:20 rcu_sched
9 ? 00:00:00 rcu_bh
10 ? 00:00:00 migration/0
11 ? 00:00:00 watchdog/0
12 ? 00:00:00 cpuhp/0
13 ? 00:00:00 cpuhp/1
14 ? 00:00:00 watchdog/1
15 ? 00:00:00 migration/1
16 ? 00:00:02 ksoftirqd/1
18 ? 00:00:00 kworker/1:0H
19 ? 00:00:00 cpuhp/2
20 ? 00:00:00 watchdog/2
21 ? 00:00:00 migration/2
22 ? 00:00:01 ksoftirqd/2
24 ? 00:00:00 kworker/2:0H
25 ? 00:00:00 cpuhp/3
26 ? 00:00:00 watchdog/3
27 ? 00:00:00 migration/3
28 ? 00:00:04 ksoftirqd/3
30 ? 00:00:00 kworker/3:0H
31 ? 00:00:00 kdevtmpfs
32 ? 00:00:00 netns
33 ? 00:00:00 rcu_tasks_kthre
34 ? 00:00:00 kauditd
37 ? 00:00:00 khungtaskd
38 ? 00:00:00 oom_reaper
39 ? 00:00:00 writeback
40 ? 00:00:01 kcompactd0
41 ? 00:00:00 ksmd
42 ? 00:00:00 khugepaged
43 ? 00:00:00 crypto
44 ? 00:00:00 kintegrityd
45 ? 00:00:00 kblockd
46 ? 00:00:00 ata_sff
47 ? 00:00:00 md
48 ? 00:00:00 edac-poller
49 ? 00:00:00 devfreq_wq
50 ? 00:00:00 watchdogd
54 ? 00:02:28 kswapd0
55 ? 00:00:01 kworker/u9:0
56 ? 00:00:00 ecryptfs-kthrea
98 ? 00:00:00 kthrotld
99 ? 00:00:00 acpi_thermal_pm
100 ? 00:00:00 scsi_eh_0
101 ? 00:00:00 scsi_tmf_0
102 ? 00:00:00 scsi_eh_1
103 ? 00:00:00 scsi_tmf_1
105 ? 00:00:00 scsi_eh_2
106 ? 00:00:00 scsi_tmf_2
107 ? 00:00:00 scsi_eh_3
108 ? 00:00:00 scsi_tmf_3
117 ? 00:00:01 kworker/2:1H
118 ? 00:00:00 kworker/1:1H
119 ? 00:00:02 kworker/0:1H
123 ? 00:00:00 ipv6_addrconf
133 ? 00:00:00 kstrp
150 ? 00:00:00 charger_manager
208 ? 00:00:00 scsi_eh_4
209 ? 00:00:00 scsi_tmf_4
210 ? 00:00:00 scsi_eh_5
211 ? 00:00:00 scsi_tmf_5
216 ? 00:00:01 kworker/3:1H
221 ? 00:00:40 kworker/0:2
228 ? 00:00:00 scsi_eh_7
229 ? 00:00:00 scsi_tmf_7
230 ? 00:00:13 usb-storage
352 ? 00:00:00 btrfs-worker
353 ? 00:00:00 btrfs-worker-hi
354 ? 00:00:00 btrfs-delalloc
355 ? 00:00:00 btrfs-flush_del
356 ? 00:00:00 btrfs-cache
357 ? 00:00:00 btrfs-submit
358 ? 00:00:00 btrfs-fixup
359 ? 00:00:00 btrfs-endio
360 ? 00:00:00 btrfs-endio-met
361 ? 00:00:00 btrfs-endio-met
362 ? 00:00:00 btrfs-endio-rai
363 ? 00:00:00 btrfs-endio-rep
364 ? 00:00:00 btrfs-rmw
365 ? 00:00:00 btrfs-endio-wri
366 ? 00:00:00 btrfs-freespace
367 ? 00:00:00 btrfs-delayed-m
368 ? 00:00:00 btrfs-readahead
369 ? 00:00:00 btrfs-qgroup-re
370 ? 00:00:00 btrfs-extent-re
371 ? 00:00:00 btrfs-cleaner
372 ? 00:00:05 btrfs-transacti
413 ? 00:00:03 systemd-journal
424 ? 00:00:00 lvmetad
437 ? 00:00:00 systemd-udevd
592 ? 00:00:00 nv_queue
593 ? 00:00:00 nv_queue
626 ? 00:00:00 nvidia-modeset/
627 ? 00:00:00 nvidia-modeset/
655 ? 00:00:00 UVM global queu
657 ? 00:00:00 UVM deferred re
661 ? 00:00:00 UVM Tools Event
717 ? 00:00:00 btrfs-worker
718 ? 00:00:00 btrfs-worker-hi
719 ? 00:00:00 btrfs-delalloc
720 ? 00:00:00 btrfs-flush_del
721 ? 00:00:00 btrfs-cache
722 ? 00:00:00 btrfs-submit
723 ? 00:00:00 btrfs-fixup
724 ? 00:00:00 btrfs-endio
725 ? 00:00:00 btrfs-endio-met
726 ? 00:00:00 btrfs-endio-met
727 ? 00:00:00 btrfs-endio-rai
728 ? 00:00:00 btrfs-endio-rep
729 ? 00:00:00 btrfs-rmw
730 ? 00:00:00 btrfs-endio-wri
731 ? 00:00:00 btrfs-freespace
732 ? 00:00:00 btrfs-delayed-m
733 ? 00:00:00 btrfs-readahead
734 ? 00:00:00 btrfs-qgroup-re
735 ? 00:00:00 btrfs-extent-re
739 ? 00:00:00 btrfs-cleaner
740 ? 00:00:15 btrfs-transacti
754 ? 00:00:00 btrfs-worker
755 ? 00:00:00 btrfs-worker-hi
756 ? 00:00:00 btrfs-delalloc
757 ? 00:00:00 btrfs-flush_del
758 ? 00:00:00 btrfs-cache
759 ? 00:00:00 btrfs-submit
760 ? 00:00:00 btrfs-fixup
761 ? 00:00:00 btrfs-endio
762 ? 00:00:00 btrfs-endio-met
763 ? 00:00:00 btrfs-endio-met
764 ? 00:00:00 btrfs-endio-rai
765 ? 00:00:00 btrfs-endio-rep
766 ? 00:00:00 btrfs-rmw
767 ? 00:00:00 btrfs-endio-wri
768 ? 00:00:00 btrfs-freespace
769 ? 00:00:00 btrfs-delayed-m
770 ? 00:00:00 btrfs-readahead
771 ? 00:00:00 btrfs-qgroup-re
772 ? 00:00:00 btrfs-extent-re
777 ? 00:00:00 btrfs-cleaner
778 ? 00:00:27 btrfs-transacti
832 ? 00:00:00 systemd-timesyn
833 ? 00:00:11 systemd-resolve
911 ? 00:00:00 rsyslogd
913 ? 00:00:00 smartd
915 ? 00:00:00 nvidia-persiste
916 ? 00:00:20 udisksd
918 ? 00:00:00 ModemManager
919 ? 00:00:01 dbus-daemon
926 ? 00:00:01 NetworkManager
929 ? 00:00:00 wpa_supplicant
932 ? 00:00:02 irqbalance
946 ? 00:00:00 avahi-daemon
952 ? 00:00:00 networkd-dispat
953 ? 00:00:00 cron
956 ? 00:00:00 bluetoothd
957 ? 00:00:11 acpid
958 ? 00:00:01 systemd-logind
959 ? 00:00:00 accounts-daemon
971 ? 00:00:00 avahi-daemon
1004 ? 00:00:03 polkitd
1010 ? 00:00:00 kerneloops
1013 ? 00:00:00 kerneloops
1047 ? 00:00:00 lightdm
1058 tty7 01:55:49 Xorg
1059 tty1 00:00:00 agetty
1078 ? 00:10:31 irq/30-nvidia
1079 ? 00:00:00 nvidia
1080 ? 00:00:38 nv_queue
1157 ? 00:00:00 upowerd
1195 ? 00:00:00 dhclient
1200 ? 00:00:00 lightdm
1344 ? 00:00:00 systemd
1345 ? 00:00:00 (sd-pam)
1362 ? 00:00:00 gnome-keyring-d
1365 ? 00:00:04 cinnamon-sessio
1378 ? 00:00:04 dbus-daemon
1429 ? 00:00:00 ssh-agent
1441 ? 00:00:00 at-spi-bus-laun
1446 ? 00:00:00 dbus-daemon
1448 ? 00:00:02 at-spi2-registr
1453 ? 00:00:11 cinnamon-screen
1459 ? 00:00:00 gvfsd
1464 ? 00:00:00 gvfsd-fuse
1483 ? 00:00:01 csd-a11y-keyboa
1484 ? 00:00:01 csd-a11y-settin
1486 ? 00:00:01 csd-automount
1487 ? 00:00:01 csd-background
1488 ? 00:00:01 csd-xsettings
1490 ? 00:00:01 csd-color
1494 ? 00:00:03 csd-housekeepin
1495 ? 00:00:03 csd-keyboard
1496 ? 00:07:58 pulseaudio
1498 ? 00:00:00 rtkit-daemon
1502 ? 00:00:01 csd-cursor
1503 ? 00:00:01 csd-clipboard
1507 ? 00:00:02 csd-media-keys
1510 ? 00:00:01 csd-mouse
1515 ? 00:00:01 csd-orientation
1526 ? 00:00:03 csd-power
1527 ? 00:00:01 csd-print-notif
1532 ? 00:00:02 csd-screensaver
1536 ? 00:00:01 csd-sound
1544 ? 00:00:01 csd-wacom
1546 ? 00:00:01 csd-xrandr
1556 ? 00:00:01 gvfs-udisks2-vo
1558 ? 00:00:00 dconf-service
1578 ? 00:00:00 gvfs-mtp-volume
1583 ? 00:00:00 gvfs-gphoto2-vo
1591 ? 00:00:00 gvfs-goa-volume
1596 ? 00:00:00 csd-printer
1601 ? 00:00:00 goa-daemon
1605 ? 00:00:00 colord
1618 ? 00:00:00 goa-identity-se
1625 ? 00:00:00 gvfs-afc-volume
1639 ? 00:00:00 btrfs-worker
1640 ? 00:00:00 btrfs-worker-hi
1641 ? 00:00:00 btrfs-delalloc
1642 ? 00:00:00 btrfs-flush_del
1643 ? 00:00:00 btrfs-cache
1644 ? 00:00:00 btrfs-submit
1645 ? 00:00:00 btrfs-fixup
1646 ? 00:00:00 btrfs-endio
1647 ? 00:00:00 btrfs-endio-met
1648 ? 00:00:00 btrfs-endio-met
1649 ? 00:00:00 btrfs-endio-rai
1650 ? 00:00:00 btrfs-endio-rep
1651 ? 00:00:00 btrfs-rmw
1652 ? 00:00:00 btrfs-endio-wri
1653 ? 00:00:00 btrfs-freespace
1654 ? 00:00:00 btrfs-delayed-m
1655 ? 00:00:00 btrfs-readahead
1656 ? 00:00:00 btrfs-qgroup-re
1657 ? 00:00:00 btrfs-extent-re
1688 ? 00:00:00 krfcommd
1693 ? 00:00:00 cinnamon-launch
1694 ? 00:40:51 cinnamon
1709 ? 00:00:01 polkit-gnome-au
1725 ? 00:00:04 nemo-desktop
1726 ? 00:00:00 nm-applet
1729 ? 00:00:00 cinnamon-killer
1730 ? 00:00:00 blueberry-obex-
1760 ? 00:00:00 obexd
1764 ? 00:00:00 python3
1776 ? 00:00:00 gvfsd-metadata
1803 ? 00:00:00 gvfsd-trash
1819 ? 00:00:00 blueberry-tray
1831 ? 00:00:00 python3
1832 ? 00:00:00 rfkill
1834 ? 00:00:00 btrfs-cleaner
1835 ? 00:00:36 btrfs-transacti
1856 ? 00:00:01 mintUpdate
2003 ? 00:00:01 applet.py
2046 ? 00:00:00 kworker/u9:5
2048 ? 00:35:08 transmission-gt
2390 ? 00:04:22 thunderbird
2520 ? 03:13:56 firefox
2575 ? 00:24:16 Web Content
2656 ? 00:00:14 WebExtensions
2701 ? 00:20:06 Web Content
2749 ? 00:07:14 Web Content
2773 ? 06:23:32 Web Content
2951 ? 00:00:00 gvfsd-http
3021 ? 00:00:02 sd_dummy
3024 ? 00:00:02 sd_espeak-ng
3030 ? 00:00:03 sd_generic
3033 ? 00:00:00 speech-dispatch
3426 ? 00:12:02 Web Content
4486 ? 00:00:00 packagekitd
10559 ? 00:32:50 gnome-system-mo
10668 ? 00:00:00 bwrap
10676 ? 00:00:31 kworker/2:1
10677 ? 00:00:00 flatpak-session
10682 ? 00:00:00 xdg-document-po
10685 ? 00:00:00 xdg-permission-
10696 ? 00:00:00 bwrap
10697 ? 00:00:00 flatpak-dbus-pr
10699 ? 00:00:00 bwrap
10700 ? 00:04:55 quodlibet
10721 ? 00:00:00 xdg-desktop-por
10726 ? 00:00:00 sh
10727 ? 00:00:00 pxgsettings
10732 ? 00:00:00 xdg-desktop-por
12628 ? 00:00:27 kworker/1:1
13788 ? 00:05:11 Web Content
13833 ? 00:03:50 Web Content
14272 ? 00:00:00 cupsd
14273 ? 00:00:00 cups-browsed
14691 ? 00:00:23 kworker/3:2
14987 ? 00:00:49 nemo
16171 ? 00:00:00 gconfd-2
17967 ? 00:01:20 RDD Process
18186 ? 00:00:00 kworker/0:1
19659 ? 00:00:03 kworker/u8:8
20994 ? 00:00:00 sh
20995 ? 00:00:00 gvfsd-admin
21137 ? 00:00:12 xed
22109 ? 00:00:01 kworker/u8:4
22193 ? 00:00:38 Web Content
22836 ? 00:00:00 gvfsd-network
22859 ? 00:00:00 gvfsd-dnssd
22913 ? 00:00:00 kworker/3:0
22971 ? 00:00:01 kworker/u8:2
23264 ? 00:00:01 kworker/u8:0
23485 ? 00:00:00 kworker/1:2
23622 ? 00:00:00 kworker/2:0
23731 ? 00:00:00 kworker/u8:3
23822 ? 00:00:01 gnome-terminal-
23829 pts/0 00:00:00 bash
23845 pts/0 00:00:00 dbus-launch
23846 ? 00:00:00 dbus-daemon
23855 ? 00:00:00 gvfsd
23860 ? 00:00:00 gvfsd-fuse
23880 ? 00:00:00 kworker/u8:5
24011 ? 00:00:00 kworker/u8:1
24032 ? 00:00:00 mintreport
24034 ? 00:00:02 mintreport
24133 pts/0 00:00:00 ps

Works in pcmanfm

Installing epub-thumbnailer to /usr/bin/ ...
OK
sh: 1: gnome-session: not found
sh: 1: gnome-shell: not found
Could not determine your desktop environment version. You can still use the thumbnailer script manually.

Bunsenlab debian stretch
I found that it install.py install /usr/bin/epub-thumbnailer but omits /usr/share/thumbnailers/epub.thumbnailer

I manually copy from master/src to /usr/share/thumbnailers/epub.thumbnailer and it worked with majority of epubs.

Thanks very much

Saydyn

Pillow might need to be installed globally

Just a minor note - I think the thumbnailer requires a global installation of Pillow, instead of at the user level.

sudo python3 install.py install

results in the following error

Required dependencies:
    Python Imaging Library .......
    ... Not found

After I installed Pillow globally
sudo pip3 install Pillow

Then I could run the install script successfully, and now it's working. Installing packages globally doesn't appear to be a common Python practice from what I could find, but maybe it's needed in certain situations like here. Posting this in case it helps others.

Thanks for developing this - thumbnails make a big difference!

Support Python 3

Getting !!! Python Imaging Library ... Not found. My understanding is that PIL is dead and that Pillow is the way to go. Still not installing on my system. Persevering because I'm hoping this does a better job than gnome-epub-thumbnailer. Thanks.

On Ubuntu 20.04 thumbnails are not generated

I have installed it on the latest Ubuntu (20.04) with python3 correctly but on nautilus, thumbnails are not shown.

SyntaxError: Missing parentheses in call to 'print'

Getting this message when trying to install (Arch Linux). Seems to be a python version issue. Does this work on python 3? Thanks.

Wrong way to determine Gnome version

You do os.popen('apt-cache show gnome-shell | grep Version') and this fails because my system has no such command apt-cache (it is only for Debian-based systems like ubuntu and I use Fedora Core Linux).

The proper way to determine the version of gnome is to run gnome-shell --version. Anyway, I'll hardcode your check_gnome_version() function to return gnome3 and see if the result works. If it does, then your script is exactly what I was about to write (as I need it for the system I am developing) and so you may have saved me a lot of time --- thank you! :)

Can't install on macOS

I try to install this script on macOS.

But it report error:

$ sudo python install.py install
Password:
Checking dependencies ...

Required dependencies:
    Python Imaging Library .......
OK

You do not have write permissions to /usr/bin/ (maybe you need to sudo)

I used sudo but install.py script still error I don't have sudo permission.

Do I need to do extra settings under macOS?

unable to install on arch linux

the message error :

Checking dependencies ...

Required dependencies:
    Python Imaging Library .......
OK

Installing epub-thumbnailer to /usr/bin/ ...
Could not install

i'm running python version 3.10.4

i have pillow installed on my machine.

Failed in Fedora 34

The script failed to determine desktop environment in nautilus 40.2 in Fedora 34 x86_64 running Gnome 40.7 and Default WM (Mutter?):-

Checking dependencies ...

Required dependencies:
    Python Imaging Library .......
OK

Installing epub-thumbnailer to /usr/bin/ ...
OK

Could not determine your desktop environment version. You can still use the thumbnailer script manually.

For example:

    epub-thumbnailer Lawrence\ Lessig\ -\ Free\ Culture.epub cover.png 128

Also, please consider reporting this in https://github.com/marianosimone/epub-thumbnailer/
including information about your distribution, window manager, file manager and the result of `ps -A`

The script doesn't work from cli either. When i run epub-thumbnailer <filename>.epub :-

Traceback (most recent call last):
  File "/usr/bin/epub-thumbnailer", line 132, in <module>
    output_file = sys.argv[2]
IndexError: list index out of range

Output of ps -A: ps.txt

python --version: Python 3.9.9

Similar issue has been reported in Ubuntu 21.10 #34 which runs the same desktop environment.