Using image generators | laravel-medialibrary | Spatie SPATIE Laravel Media Library ======================== spatie.be/open-source [Docs](https://spatie.be/docs) [Laravel-medialibrary](https://spatie.be/docs/laravel-medialibrary/v4) Converting-other-file-types Using image generators Version v11 v10 v9 v8 v7 v6 v5 v4 v3 Other versions for crawler [v11](https://spatie.be/docs/laravel-medialibrary/v11) [v10](https://spatie.be/docs/laravel-medialibrary/v10) [v9](https://spatie.be/docs/laravel-medialibrary/v9) [v8](https://spatie.be/docs/laravel-medialibrary/v8) [v7](https://spatie.be/docs/laravel-medialibrary/v7) [v6](https://spatie.be/docs/laravel-medialibrary/v6) [v5](https://spatie.be/docs/laravel-medialibrary/v5) [v4](https://spatie.be/docs/laravel-medialibrary/v4) [v3](https://spatie.be/docs/laravel-medialibrary/v3) - [ Introduction ](https://spatie.be/docs/laravel-medialibrary/v4/introduction) - [ Postcardware ](https://spatie.be/docs/laravel-medialibrary/v4/postcardware) - [ Requirements ](https://spatie.be/docs/laravel-medialibrary/v4/requirements) - [ Installation & setup in Laravel ](https://spatie.be/docs/laravel-medialibrary/v4/installation-setup-in-laravel) - [ Installation & setup in Lumen ](https://spatie.be/docs/laravel-medialibrary/v4/installation-setup-in-lumen) - [ Questions and issues ](https://spatie.be/docs/laravel-medialibrary/v4/questions-issues) - [ Changelog ](https://spatie.be/docs/laravel-medialibrary/v4/changelog) - [ About us ](https://spatie.be/docs/laravel-medialibrary/v4/about-us) Basic usage ----------- - [ Preparing your model ](https://spatie.be/docs/laravel-medialibrary/v4/basic-usage/preparing-your-model) - [ Associating files ](https://spatie.be/docs/laravel-medialibrary/v4/basic-usage/associating-files) - [ Retrieving media ](https://spatie.be/docs/laravel-medialibrary/v4/basic-usage/retrieving-media) - [ Working with collections ](https://spatie.be/docs/laravel-medialibrary/v4/basic-usage/working-with-collections) Converting images ----------------- - [ Defining conversions ](https://spatie.be/docs/laravel-medialibrary/v4/converting-images/defining-conversions) - [ Retrieving converted images ](https://spatie.be/docs/laravel-medialibrary/v4/converting-images/retrieving-converted-images) - [ Regenerating images ](https://spatie.be/docs/laravel-medialibrary/v4/converting-images/regenerating-images) Converting other file types --------------------------- - [ Creating a custom image generator ](https://spatie.be/docs/laravel-medialibrary/v4/converting-other-file-types/creating-a-custom-image-generator) - [ Using image generators ](https://spatie.be/docs/laravel-medialibrary/v4/converting-other-file-types/using-image-generators) Advanced usage -------------- - [ Working with multiple filesystems ](https://spatie.be/docs/laravel-medialibrary/v4/advanced-usage/working-with-multiple-filesystems) - [ Adding custom properties ](https://spatie.be/docs/laravel-medialibrary/v4/advanced-usage/adding-custom-properties) - [ Generating custom urls ](https://spatie.be/docs/laravel-medialibrary/v4/advanced-usage/generating-custom-urls) - [ Storing media specific manipulations ](https://spatie.be/docs/laravel-medialibrary/v4/advanced-usage/storing-media-specific-manipulations) - [ Using your own model ](https://spatie.be/docs/laravel-medialibrary/v4/advanced-usage/using-your-own-model) - [ Using a custom directory structure ](https://spatie.be/docs/laravel-medialibrary/v4/advanced-usage/using-a-custom-directory-structure) - [ Ordering media ](https://spatie.be/docs/laravel-medialibrary/v4/advanced-usage/ordering-media) - [ Consuming events ](https://spatie.be/docs/laravel-medialibrary/v4/advanced-usage/consuming-events) - [ Overriding the default filesystem behavior ](https://spatie.be/docs/laravel-medialibrary/v4/advanced-usage/overriding-default-filesystem-behaviour) API --- - [ Adding files ](https://spatie.be/docs/laravel-medialibrary/v4/api/adding-files) - [ Defining conversions ](https://spatie.be/docs/laravel-medialibrary/v4/api/defining-conversions) You are viewing the documentation for **an older version** of this package. You can check the version you are using with the following command: ` composer show spatie/laravel-medialibrary ` Using image generators ====================== ### On this page 1. [ PDF ](#content-pdf) 2. [ SVG ](#content-svg) 3. [ Video ](#content-video) As explained in the [Defining conversions](/laravel-medialibrary/v4/converting-images/defining-conversions/) section this package use [Glide](http://glide.thephpleague.com/) under the hood which only perform conversions on images files. To generate conversions of other media types – most notably PDFs and videos – the medialibrary uses a image generators to create a derived image file of the media. Conversion of specific file type are defined in the exact same way as images: ``` $this->addMediaConversion('thumb') ->setManipulations(['w' => 368, 'h' => 232]) ->performOnCollections('videos'); ``` The medialibrary includes image generators for the following file types: - [PDF](/laravel-medialibrary/v4/converting-other-file-types/using-image-generators#pdf) - [SVG](/laravel-medialibrary/v4/converting-other-file-types/using-image-generators#svg) - [Video](/laravel-medialibrary/v4/converting-other-file-types/using-image-generators#video) PDF ----------------------------------------------------------------- The only requirement to perform a conversion of a PDF file is [Imagick](http://php.net/manual/en/imagick.setresolution.php). SVG ----------------------------------------------------------------- The only requirement to perform a conversion of a SVG file is [Imagick](http://php.net/manual/en/imagick.setresolution.php). Video ----------------------------------------------------------------------- The video image generator uses the [PHP-FFMpeg](https://github.com/PHP-FFMpeg/PHP-FFMpeg) package that you can install via composer: ``` $ composer require php-ffmpeg/php-ffmpeg ``` You'll also need to follow `FFmpeg` installation instructions on their [official website](https://ffmpeg.org/download.html). The video image generator allows you to choose at which time of the video the derived file should be created using the `setExtractVideoFrameAtSecond` on the conversion. ``` $this->addMediaConversion('thumb') ->setManipulations(['w' => 368, 'h' => 232]) ->setExtractVideoFrameAtSecond(20) ->performOnCollections('videos'); ``` Once the conversion is created you can easily use the thumbnail in a html `video` tag for example: ``` Your browser does not support the video tag. ```