Preview settings not described well

ℹ️ Support
,
1

HI,

I had faced an issue with preview generator, where previews had not been generated. I had found out after a while, that reviews for videos did work however, after I had enabled the provider. However it took me a while, to find out, that I also had to enable image provider if I enable a provider that is not standard. Also I am not sure and could not find out in nextcloud documentstion, how to enable preview for mp3 or txt files.
It would be good if that fact was noted in the configuration manual and also which providers are possible…

2

Here it is:

https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html#enabledpreviewproviders

3

Thanx, I had been reading this and didnt find what I needed:
https://docs.nextcloud.com/server/latest/admin_manual/configuration_files/previews_configuration.html

4

Not sure, but seems info there is also not complete. Using

‘OC\Preview\Image’,

I enabled Foto and other previews.
Are there other undocumented providers?

5

Not complete how? Is there a specific problem you’re encountering?

6

Not an issue, I had tried the OC\Preview\Image provider by trial and error and it worked, before had j-ed’s answer but I did not find it mentioned in his link, only all image types seperately…

7

I’m still not following. OC\Preview\Image is not a valid preview provider nor is it documented on in the linked page as being one.

8

Hmm, I initially did not have any provider configured for some reason that is not yet clear to me. At some point I realized that I don’t get previews for videos and so enabled the provider OC/Preview/Movie which I found in some older forum thread as a solution to my problem. After that my foto previews did not work anymore (at least I thought they did work until that moment, but I could errthere), so I was looking for a solution and adding OC/Preview/Image did for some reason solve my problem. I did not see any other issue from then except I missed Cover Pics for Audio Files. Now adding the MP3 provider fixed that for MP3 files, but that did not help for flac files, which also have cover art embedded. So I thought using something like OC/Preview/Audio could do the trick, but it didnt…
Do u have any suggestion for my flag files, or is it just not implemented?

9

  • Nextcloud Preview Providers that can be added to the enabledPreviewProviders array in the config/config.php file.

No External Dependencies

These providers can be enabled without any additional software dependencies.

  • OC\Preview\PNG
  • OC\Preview\JPEG
  • OC\Preview\GIF
  • OC\Preview\BMP
  • OC\Preview\XBitmap
  • OC\Preview\MarkDown
  • OC\Preview\MP3
  • OC\Preview\TXT
  • OC\Preview\Krita

ImageMagick Dependency

These providers require the ImageMagick extension to be installed and enabled.

  • OC\Preview\SVG
  • OC\Preview\TIFF
  • OC\Preview\PDF
  • OC\Preview\Illustrator
  • OC\Preview\Photoshop
  • OC\Preview\Postscript
  • OC\Preview\Font
  • OC\Preview\HEIC
  • OC\Preview\TGA
  • OC\Preview\SGI

Office Dependency

These providers require LibreOffice or OpenOffice to be installed.

  • OC\Preview\MSOfficeDoc
  • OC\Preview\MSOffice2003
  • OC\Preview\MSOffice2007
  • OC\Preview\OpenDocument
  • OC\Preview\StarOffice
  • OC\Preview\EMF

Imaginary Dependency

These providers require the Imaginary service to be set up.

  • OC\Preview\Imaginary
    Imaginary supports these MIME types:
    • image/bmp
    • image/x-bitmap
    • image/png
    • image/jpeg
    • image/gif
    • image/heic
    • image/heif
    • image/svg+xml
    • image/tiff
    • image/webp
    • application/illustrator
    • application/pdf (NC < 30)
  • OC\Preview\ImaginaryPDF (since NC 30)
    • application/pdf

AVConf/FFmpeg Dependency

These providers require AVConf/FFmpeg to be installed.

  • OC\Preview\Movie
    • All video MIME types supported by avconf/ffmpeg

Additional Providers

These providers support specific file types and might require additional configuration.

  • OC\Preview\WebP // // Requires PHP support for WebP images (php-gd)

  • Preview providers that do not need to be added to the enabledPreviewProviders array in the config/config.php file.

OC\Preview\Image: This provider is used internally and extended by other image providers. Adding OC\Preview\Image is unnecessary as it is automatically used by the specific image providers (PNG, JPEG, GIF, etc.).

  • Nextcloud Preview Providers that can NOT be added to the enabledPreviewProviders array in the config/config.php file.

Nextcloud Office

Nextcloud Office also creates thumbnails if the Collabora Office Server supports this. The Builtin CODE Server supports this and this support cannot be deactivated.
The Previews created by Nextcloud Office can not be changed in any way in the enabledPreviewProviders array in the config/config.php file.

  • image/emf
  • application/vnd.ms-excel
  • application/msword
  • application/vnd.openxmlformats-officedocument.*
  • application/vnd.oasis.opendocument.*
    • .odt, .ott, .oth, .odm, .odg, .otg, .odp, .otp, .ods, .ots, .odc, .odf, .odb, .odi, .oxt
  • application/pdf (only if OC\Preview\PDF is not set)

I hope I did not oversee any.
This is the actual situation. This may (/will) change in future.

Much and good luck,
ernolf

3 Likes
10

@ernolf You feel up to proposing an edit/PR to the Previews Configuration chapter including that language? All I had time for today was a light adjustment to mention enabledPreviewProviders in that chapter.

3 Likes
11

Nextcloud 30 comes with its own preview provider for ImaginaryPDF

Feat(preview): introducing new class ImaginaryPDF (server#46508)

The above list has been adjusted:

ernolf