Error when running media-filter Dspace 8

16 views
Skip to first unread message

Wanangwa Nyirenda

unread,
Mar 5, 2026, 4:02:32 AM (9 days ago) Mar 5
to DSpace Technical Support
I got the following error when trying to run my media filter to generate a thumbnails for my books.                          

ERROR:Unknon MediaFilter specified (either from command-line or in dspace.cfg): 'PDFThumbnail'

Any help is greatly appreciated,

Wanangwa.

DSpace Technical Support

unread,
Mar 12, 2026, 4:49:09 PM (2 days ago) Mar 12
to DSpace Technical Support
Hi Wanangwa,

This error could be caused by some missing or incorrect media filter settings.   First, double check that you have enabled the media filters you want to use (more details in the configuration reference).  For example, to use the "PDFBox JPEG Thumbnail" filter you would check that dspace.cfg includes the lines:

filter.plugins = PDFBox JPEG Thumbnail
and
plugin.named.org.dspace.app.mediafilter.FormatFilter = org.dspace.app.mediafilter.PDFBoxThumbnail = PDFBox JPEG Thumbnail

Second, if you are running the command with -p to apply limited filters, you could check that the plugin name matches your config:

[dspace]/bin/dspace filter-media -p "PDFBox JPEG Thumbnail"

Best,
Lia
Reply all
Reply to author
Forward
0 new messages