daun/statamic-asset-thumbnails

Generate asset thumbnails for exotic file formats like videos, raw photos, audio files and documents

1.1.0 2026-03-06 20:09 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.8
• laravel/framework: ^12.0
• statamic/cms: ^6.0

Requires (Dev)

• cloudconvert/cloudconvert-php: ^3.4
• larastan/larastan: ^2.9 || ^3.0
• laravel/pint: ^1.14
• mockery/mockery: ^1.6
• orchestra/testbench: ^9.0 || ^10.0
• pestphp/pest: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• spatie/ray: ^1.42
• transloadit/php-sdk: ^3.2

Suggests

• cloudconvert/cloudconvert-php: Required to generate asset thumbnails using CloudConvert
• transloadit/php-sdk: Required to generate asset thumbnails using Transloadit

Conflicts

• cloudconvert/cloudconvert-php: <3.0 || >=4.0
• transloadit/php-sdk: <3.0 || >=4.0

MIT

• Philipp Daun

• image
• asset
• thumbnail
• audio
• document
• video
• photo
• preview
• statamic

README

Generate asset thumbnails for exotic file formats like videos, raw photos, audio files and documents.

How It Works

The addon generates control panel thumbnails for non-image files by integrating with a third-party file conversion service and download the resulting preview image.

File Conversion Services

Transloadit
9$/month for 5GB of uploads
Free tier allows 5GB of uploads & adds watermarks to thumbnails

CloudConvert
10€/month for 1000 uploads / 18€ once for 1000 credits
Free tier allows 10 thumbnails per day

Transloadit supports a few more file formats and advanced customization. The most obvious difference is audio files: Transloadit can generate thumbnails from wave forms or embedded artwork, while CloudConvert does not support audio files at all.

Quick Start

1. Install using composer require daun/statamic-asset-thumbnails
2. Configure the driver and credentials in config/statamic/asset-thumbnails.php
3. Install the required composer packages for your chosen driver:
   • Transloadit: composer require transloadit/php-sdk
   • CloudConvert: composer require cloudconvert/cloudconvert-php
4. Any supported files will now automatically get a thumbnail in the control panel
5. Recommended: set up a custom cache disk for faster thumbnail loading (see below for details)
6. Recommended: disable thumbnail generation in local/dev environments to save on conversion credits

File Formats

Both drivers support the following file formats:

• Image: tiff, bmp
• Video: mp4, mov, avi, mkv, webm, wmv
• Photo: raw, dng, heic, heif, nef, cr2, cr3, crw
• Document: pdf, doc, docx, ppt, pptx, xls, xlsx, rtf, txt
• Adobe: psd, psb, eps

Transloadit supports a few additional formats:

• Audio: mp3, aac, aif, m4a, off, opus, flac, wav
• Video: h264
• Adobe: ai
• Photo: nrw, dcm

Cache Disk

The default setup streams cached thumbnails from a custom controller. This simplifies initial setup, but comes with some overhead. To make thumbnails load faster, you can define a custom disk inside your app's public folder. Thumbnails can then be served directly from a public url, circumventing Laravel entirely.

First, define a new disk in config/filesystems.php.

'disks' => [
+  'thumbnails' => [
+    'driver' => 'local',
+    'root' => storage_path('app/public/thumbnails'),
+    'url' => env('APP_URL').'/storage/thumbnails',
+    'visibility' => 'public',
+  ],
],

Then, update the cache disk in config/statamic/asset-thumbnails.php.

'cache' => [
-  'disk' => null,
+  'disk' => 'thumbnails',
],

Commands

You can clear the thumbnail cache using the following command:

php please thumbnails:clear

License

This addon is paid software with an open-source codebase. To use it in production, you'll need to buy a license from the Statamic Marketplace.