Error when running media-filter Dspace 8

30 views
Skip to first unread message

Wanangwa Nyirenda

unread,
Mar 5, 2026, 4:02:32 AMMar 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 PMMar 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

Wanangwa Nyirenda

unread,
Apr 21, 2026, 4:15:26 AM (3 days ago) Apr 21
to DSpace Technical Support
I am so sorry I forgot to say thank you for the help. I actually tried your solution and it didn't work at the time so I decided to distract myself with other tasks and get back to this one later. When I got back to it I found out it was actually a permission issue. My dspace user didn't have the proper permission to be able to create thumbnails from the books only the superuser did, so it might be worth mentioning to check file permissions to the next user that has a problem like this. I tried your solution after fixing my permissions and it worked perfectly.                      

Thank you so much Lia. Stay blessed.

Yours with gratitude,

Wanangwa.  

--
All messages to this mailing list should adhere to the Code of Conduct: https://lyrasis.org/code-of-conduct/
---
You received this message because you are subscribed to the Google Groups "DSpace Technical Support" group.
To unsubscribe from this group and stop receiving emails from it, send an email to dspace-tech...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/dspace-tech/5e48b688-006e-408a-927a-b067166d201cn%40googlegroups.com.
Reply all
Reply to author
Forward
0 new messages