halbkreativ / tinyimg

TYPO3-Extension which compresses images (png & jpg) uploaded in the backend with the tinypng API

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

TYPO3 Extension tinyimg

Image compression for all pngs and jpgs uploaded to the backend (using the tinypng API)

What does it do?

It's a small extension, that hooks (using signals) into the TYPO3 file upload and compresses every jpg or png uploaded to the backend using the tinify API: https://tinypng.com/developers

This API can reduce up to 80% of the file size of your images, which will increase your page speed. Without loosing quality.

Installation via composer

  1. Get extension tinyimg: composer require schmitzal/tinyimg
  2. Active extension (using extension manager or commandline)

Installation via extension manager

Installing the extension via extension manager is possible but as tinyimg requires the tinify/tinify library you will have to take care of installing this package manually.


  1. Create an API key* at https://tinypng.com/developers
  2. Enter the API key* in the extension configuration
  3. Include the static TypoScript. It disables compression while on application context "Development" - so you wont loose compressions during development and testing
  4. Have a nice day :)

*Note that the tinify API is limited to 500 compressions per month. If you need more, there is a payed version which can be activated in your dashboard (where you got your API key)

Setup for already existing projects

This extension contains an extbase command which runs through all files storages and compresses 100 images in it on each run. Depending on the size of this images this takes a while.

Make sure to have an updated index. TYPO3 comes with an index updater as a scheduler task called "File Abstraction Layer: Update storage index (scheduler)".

Also be aware that the tinify API is limited to 500 free compressions (see note above). So on huge websites it will be reached quickly.

TypoScript reference

Setting Type Default Description
debug bool 0 Enable or disable debugging mode. Stops extension from compressing images. Use in development mode to avoid waisting compressions.
excludeFolders string empty Comma-separated list of folders which should be excluded from compression. Relative from storage (e.g. fileadmin), starting with "/" (e.g. "/user_upload,/folder_under_fileadmin")


Bugs and feature requests are welcome. Feel free to create an issue and i'll have a look at it as soon as possible.

Code improvements are also highly appreciated, as I'm a young developer and sure there is stuff to optimize.


This extension is powered by Interlutions GmbH. Most of the time working on this extension is at work, so my thanks go to Interlutions. :)


TYPO3-Extension which compresses images (png & jpg) uploaded in the backend with the tinypng API

License:GNU General Public License v3.0


Language:PHP 89.2%Language:HTML 8.4%Language:JavaScript 2.1%Language:CSS 0.4%