Unknown encoder 'webp' error from filter-media video thumbnail generation

20 views
Skip to first unread message

alex buckley

unread,
Sep 17, 2025, 12:19:05 AM9/17/25
to DSpace Developers
Hi DSpace community,

We have a partner library running DSpace 7.6.3 on a RedHat server.

Now the backend DSpace server has ImageMagick installed, and we are able to successfully manually test ImageMagick webp conversion.

However, when we manually run the filter-media script on an item the video thumbnail generation fails with  org.im4java.core.CommandException: Unknown encoder 'webp' - see below output:

---

[dspace]# bin/dspace filter-media -v -i '10292/19016'
The script has started
The following MediaFilters are enabled:
Full Filter Name: org.dspace.app.mediafilter.ImageMagickVideoThumbnailFilter
org.dspace.app.mediafilter.ImageMagickVideoThumbnailFilter
PROCESSING: bitstream XXX (item: 10292/19016)
File: Black and Pink Minimalist Welcome To My Channel YouTube Video (1).mp4.jpg
IM Thumbnail Param: -auto-orient VIDEO:/tmp/imthumb8300761135230282362.tmp[100] -thumbnail 257x350 /tmp/imthumb8300761135230282362.tmp.jpg
ERROR filtering, skipping bitstream:
Item Handle: 10292/19016 Bundle Name: ORIGINAL File Size: 460491 Checksum: XXX (MD5) Asset Store: 0 Internal ID: XXX
org.im4java.core.CommandException: Unknown encoder 'webp'
Caused by: org.im4java.core.CommandException Unknown encoder 'webp'
The script has completed
[dspace]#

---


Has anyone else in the DSpace community encountered this error before and if so how did you approach fixing it?

Thanks,
Alex

Emilia Lobo

unread,
Feb 6, 2026, 11:00:54 AM (5 days ago) Feb 6
to DSpace Developers
Good morning DSpace community,

I'm working with DSpace version 7.6.2 on a Debian server. I want to start uploading herbarium images in WebP format, but the thumbnails aren't being generated by the filter-media process.
Do I need to install something else or make any additional configuration for this format?

Thanks,
Emilia

DSpace Developers

unread,
Feb 6, 2026, 3:54:51 PM (5 days ago) Feb 6
to DSpace Developers
Hi Emilia,

I'm not aware of a "media filter" in DSpace that supports WebP at this time.  Here's our available filters:  https://wiki.lyrasis.org/display/DSDOC7x/Mediafilters+for+Transforming+DSpace+Content#MediafiltersforTransformingDSpaceContent-AvailableMediaFilters

Not all formats get thumbnails, and only the ones listed on that page are verified to work at this time.

It might be possible to achieve it through the ImageMagick filter (as it supports the most image formats), but I'm not seeing any clear documentation on what needs to be done to achieve that in our ImageMagick docs at https://wiki.lyrasis.org/display/DSDOC7x/ImageMagick+Media+Filters   At the very least, you'd have to add the WebP format to DSpace itself and configure it to use the ImageMagick filter. But, I don't know whether that'd work or not.

Hopefully, if someone else has done this before, they'll answer on this list.

Tim

Reply all
Reply to author
Forward
0 new messages