> ## Documentation Index
> Fetch the complete documentation index at: https://studio.bjanczak.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure processing and workers

> Configure queues and per-workspace processing controls.

This page covers configuration. For worker deployment and task scheduling, see [Queues and scheduled maintenance](https://studio.bjanczak.com/queues-and-scheduler.md).

## Image thumbnails and workers

Thumbnails are separate files. Generating a thumbnail never overwrites its
original. The grid uses the small rendition when it is ready; it does not download
every full-size original to display a list.

```php theme={null}
'processing' => [
    'connection' => 'database', // Or your application's Redis queue connection.
    'queue' => 'media',
    'thumbnails' => [
        'enabled' => true,
        'edge' => 480,
        'max_pixels' => 16_000_000,
        'max_source_bytes' => 25 * 1024 * 1024,
    ],
],
```

Configure the selected Laravel queue connection and run its worker:

```bash theme={null}
php artisan queue:work database --queue=media --tries=3 --timeout=120
```

With `connection => null`, Studio uses the application's default queue connection.
A synchronous connection processes in the request; use a background worker when
you want processing to continue independently. Processing status is persisted and
can be refreshed after reopening the library.

The native image renderer supports GD and ImageMagick through
`processing.native.driver` (`auto`, `gd`, `imagick`). Codec availability determines
which WebP/AVIF inputs and outputs can be processed. Native supported inputs are
JPEG, PNG, WebP and AVIF; JPEG orientation is normalized. Images are not enlarged
unless the selected recipe explicitly enables upscaling. Metadata preservation
requires ImageMagick; [image recipes](https://studio.bjanczak.com/image-rendition-presets.md) explain the exact
selection and failure behavior.

## Select the right processing pipeline

| Input | Configuration and requirements | Guide |
| - | - | - |
| Images | Native image recipes; GD/ImageMagick and selected codec | [Image presets](https://studio.bjanczak.com/image-rendition-presets.md) |
| PDF | First page; Poppler or PDF-enabled libvips; disabled by default | [Document thumbnails](https://studio.bjanczak.com/document-thumbnails.md) |
| DOCX/XLSX/PPTX/ODF | Explicit MIME registration, LibreOffice and isolated conversion worker | [Office thumbnails](https://studio.bjanczak.com/document-thumbnails.md#office-documents) |
| TXT/Markdown/HTML | Explicit MIME registration and local Unicode font; text-only rendering | [Text thumbnails](https://studio.bjanczak.com/document-thumbnails.md#text-markdown-and-text-only-html) |
| Video | FFmpeg poster and optional MP4; asynchronous connection; disabled by default | [Video thumbnails](https://studio.bjanczak.com/video-thumbnails.md) |
| Audio | FFmpeg waveform job on its own queue | [Audio previews](https://studio.bjanczak.com/audio-previews.md) |
| Application-owned files | Separate bounded thumbnail cache; disabled by default | [Application thumbnails](https://studio.bjanczak.com/application-files-thumbnails.md) |

Document generation has independent command/queue/inline controls. Enabling PDF
text extraction or browser document preview does not enable PDF thumbnails.
Likewise, enabling video trimming does not enable video posters. Consult the
[complete settings reference](https://studio.bjanczak.com/configuration-processing.md) and
[capability matrix](https://studio.bjanczak.com/configuration-reference.md) before configuring workers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.