PHPackages                             daun/statamic-asset-thumbnails - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [PDF &amp; Document Generation](/categories/documents)
4. /
5. daun/statamic-asset-thumbnails

ActiveStatamic-addon[PDF &amp; Document Generation](/categories/documents)

daun/statamic-asset-thumbnails
==============================

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

1.1.0(2mo ago)059MITPHPPHP ^8.2CI passing

Since Oct 14Pushed 2mo agoCompare

[ Source](https://github.com/daun/statamic-asset-thumbnails)[ Packagist](https://packagist.org/packages/daun/statamic-asset-thumbnails)[ RSS](/packages/daun-statamic-asset-thumbnails/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (24)Versions (10)Used By (0)

Statamic Advanced Asset Thumbnails
==================================

[](#statamic-advanced-asset-thumbnails)

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

[![Example asset thumbnails](art/asset-thumbnails.gif)](art/asset-thumbnails.gif)

How It Works
------------

[](#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
------------------------

[](#file-conversion-services)

[Transloadit](https://transloadit.com/)
9$/month for 5GB of uploads
Free tier allows 5GB of uploads &amp; adds watermarks to thumbnails

[CloudConvert](https://cloudconvert.com/)
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
-----------

[](#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
------------

[](#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
----------

[](#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
--------

[](#commands)

You can clear the thumbnail cache using the following command:

```
php please thumbnails:clear
```

License
-------

[](#license)

This addon is paid software with an open-source codebase. To use it in production, you'll need to [buy a license](https://statamic.com/addons/daun/asset-thumbnails) from the Statamic Marketplace.

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance86

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~36 days

Total

5

Last Release

72d ago

Major Versions

0.2.1 → 1.0.02026-02-08

### Community

Maintainers

![](https://www.gravatar.com/avatar/31ac2b3787ded290b6bac87b937abf4f267483e4da64731bfb256a942bb669ca?d=identicon)[daun](/maintainers/daun)

---

Top Contributors

[![daun](https://avatars.githubusercontent.com/u/22225348?v=4)](https://github.com/daun "daun (88 commits)")

---

Tags

assetsfilespreviewstatamicstatamic-addonthumbnailsthumbnailimageaudiovideophotoassetpreviewdocumentstatamic

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/daun-statamic-asset-thumbnails/health.svg)

```
[![Health](https://phpackages.com/badges/daun-statamic-asset-thumbnails/health.svg)](https://phpackages.com/packages/daun-statamic-asset-thumbnails)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.2M720](/packages/statamic-cms)[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

188171.7k15](/packages/fof-upload)[statamic/statamic

Statamic

824170.4k](/packages/statamic-statamic)[transloadit/php-sdk

Transloadit SDK

63393.6k2](/packages/transloadit-php-sdk)[urlbox/screenshots

Use urlbox to easily generate website thumbnail screenshots from a URL

14250.4k](/packages/urlbox-screenshots)[daun/statamic-placeholders

Generate low-quality image placeholders for lazyloading Statamic assets

106.6k](/packages/daun-statamic-placeholders)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
