PHPackages move-elevator/typo3-image-compression - 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. [Image & Media](/categories/media) 4. / 5. move-elevator/typo3-image-compression ActiveTypo3-cms-extension[Image & Media](/categories/media) move-elevator/typo3-image-compression ===================================== Automatically compress images using TinyPNG API, local tools (jpegoptim, optipng, etc.), or ImageMagick/GraphicsMagick 1.0.0(5mo ago)01.2k↓23.1%1GPL-2.0-or-laterPHPPHP ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0CI passing Since Dec 5Pushed 2mo agoCompare [ Source](https://github.com/move-elevator/typo3-image-compression)[ Packagist](https://packagist.org/packages/move-elevator/typo3-image-compression)[ Docs](https://github.com/move-elevator/typo3-image-compression)[ RSS](/packages/move-elevator-typo3-image-compression/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (15)Versions (5)Used By (0) [![Extension icon](Resources/Public/Icons/Extension.svg)](Resources/Public/Icons/Extension.svg) TYPO3 extension `typo3_image_compression` ========================================= [](#typo3-extension-typo3_image_compression) [![Latest Stable Version](https://camo.githubusercontent.com/a146e7c17bf1b650840ce3eb217add24c45d3518e273335bafb78a28cf7266fe/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f7479706f335f696d6167655f636f6d7072657373696f6e2f76657273696f6e2f736869656c64732e737667)](https://extensions.typo3.org/extension/typo3_image_compression)[![Supported TYPO3 versions](https://camo.githubusercontent.com/9be803ee161e6cf29dc1ac0efb74dbca46425235244625779b122624368abb63/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f7479706f335f696d6167655f636f6d7072657373696f6e2f7479706f332f736869656c64732e737667)](https://extensions.typo3.org/extension/typo3_image_compression)[![Coverage](https://camo.githubusercontent.com/666d3a38e09e653c3c24b534c5d0694d178a62c0995485e44e16bc502b1ea3ab/68747470733a2f2f696d672e736869656c64732e696f2f636f766572616c6c73436f7665726167652f6769746875622f6d6f76652d656c657661746f722f7479706f332d696d6167652d636f6d7072657373696f6e3f6c6f676f3d636f766572616c6c73)](https://coveralls.io/github/move-elevator/typo3-image-compression)[![CGL](https://camo.githubusercontent.com/7e135a63af01f43c7d3a5aed8fd73d486af2abd38b9ff5d962508c30ad4389b1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d6f76652d656c657661746f722f7479706f332d696d6167652d636f6d7072657373696f6e2f63676c2e796d6c3f6c6162656c3d63676c266c6f676f3d676974687562)](https://github.com/move-elevator/typo3-image-compression/actions/workflows/cgl.yml)[![Tests](https://camo.githubusercontent.com/ae9f78db25dbb3ad58764258aab068d019def36fbea10dd70806dd7a168688e8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d6f76652d656c657661746f722f7479706f332d696d6167652d636f6d7072657373696f6e2f74657374732e796d6c3f6c6162656c3d7465737473266c6f676f3d676974687562)](https://github.com/move-elevator/typo3-image-compression/actions/workflows/tests.yml)[![License](https://camo.githubusercontent.com/bb4041d31248685449345438fc68ad00408495e94291eedce52b8d83b286252f/68747470733a2f2f706f7365722e707567782e6f72672f6d6f76652d656c657661746f722f7479706f332d696d6167652d636f6d7072657373696f6e2f6c6963656e7365)](LICENSE.md) This TYPO3 extension automatically compresses images uploaded to the TYPO3 backend. Choose between the TinyPNG API for best results or local tools for cost-free compression. Features -------- [](#features) - **Multiple compression providers**: TinyPNG API, local optimized tools, or ImageMagick/GraphicsMagick - Automatic compression of JPG, PNG, GIF, AVIF and WebP images on upload - CLI command for batch processing existing images - Configurable quality settings for local compression - Image compression statistic in the system information toolbar - Image compression info in sys\_file\_metadata edit view Provider Comparison ------------------- [](#provider-comparison) ProviderToolsCompressionCostBest For`tinify`TinyPNG API~70-80%API quotaProduction, best quality`local-tools`jpegoptim, optipng, pngquant, gifsicle, cwebp~50-60%FreeSelf-hosted, no API costs`local-basic`ImageMagick / GraphicsMagick~30-40%FreeJPEG only, quick setup🔥 Installation -------------- [](#-installation) ### Requirements [](#requirements) - TYPO3 >= 12.4 - PHP 8.2+ ### Composer [](#composer) [![Packagist](https://camo.githubusercontent.com/16d1b92a8e1b38316f4d2f00cefb661bb5b827a38535ad2c9451106cb494ff20/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6f76652d656c657661746f722f7479706f332d696d6167652d636f6d7072657373696f6e3f6c6162656c3d76657273696f6e266c6f676f3d7061636b6167697374)](https://packagist.org/packages/move-elevator/typo3-image-compression)[![Packagist Downloads](https://camo.githubusercontent.com/32d68240fa234de8469af769b445fd29dbbcefc624495b9059dcfad781e3d970/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6f76652d656c657661746f722f7479706f332d696d6167652d636f6d7072657373696f6e3f636f6c6f723d627269676874677265656e)](https://packagist.org/packages/move-elevator/typo3-image-compression) ``` composer require move-elevator/typo3-image-compression ``` ### TER [](#ter) [![TER version](https://camo.githubusercontent.com/a146e7c17bf1b650840ce3eb217add24c45d3518e273335bafb78a28cf7266fe/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f7479706f335f696d6167655f636f6d7072657373696f6e2f76657273696f6e2f736869656c64732e737667)](https://extensions.typo3.org/extension/typo3_image_compression)[![TER downloads](https://camo.githubusercontent.com/1ea24846910d3367b5426ec5dd7f1d70740fa68df58c43954b8b95ca21f2d32b/68747470733a2f2f7479706f332d6261646765732e6465762f62616467652f7479706f335f696d6167655f636f6d7072657373696f6e2f646f776e6c6f6164732f736869656c64732e737667)](https://extensions.typo3.org/extension/typo3_image_compression) Download the zip file from [TYPO3 extension repository (TER)](https://extensions.typo3.org/extension/typo3_image_compression). 🧰 Configuration --------------- [](#-configuration) Configure the extension in **Admin Tools > Settings > Extension Configuration**. ### Provider [](#provider) Choose the compression provider from the dropdown. #### `tinify` (TinyPNG API) [](#tinify-tinypng-api) 1. Register at [TinyPNG Developers](https://tinypng.com/developers) to obtain your API key 2. Set **Provider** to `tinify` and enter your API key 3. Free tier: **500 compressions/month**, paid upgrades via [TinyPNG dashboard](https://tinypng.com/dashboard) Warning Be aware that the free API limit (500 compressions/month) can be exhausted quickly on large sites with many existing images. #### `local-tools` (Optimized Tools) [](#local-tools-optimized-tools) Install the required tools on your server: ``` # Debian/Ubuntu apt install jpegoptim optipng pngquant gifsicle webp # macOS (Homebrew) brew install jpegoptim optipng pngquant gifsicle webp ``` Set **Provider** to `local-tools`. The extension auto-detects available tools. #### `local-basic` (ImageMagick/GraphicsMagick) [](#local-basic-imagemagickgraphicsmagick) No additional installation needed - uses TYPO3's configured graphics processor. Set **Provider** to `local-basic`. ### Quality Settings [](#quality-settings) For local providers, configure quality (1-100) for JPEG, PNG, and WebP compression. 📊 Usage ------- [](#-usage) ### Automatic Compression [](#automatic-compression) Once configured, all images (with supported mime type) uploaded via the TYPO3 backend will be automatically compressed. ### Batch Processing (CLI) [](#batch-processing-cli) For existing projects, a CLI command is available to compress images that were uploaded before the extension was installed. ``` # Compress up to 100 original images (default) vendor/bin/typo3 imagecompression:compressImages # Compress up to 50 images vendor/bin/typo3 imagecompression:compressImages 50 # Also compress processed files (thumbnails, crops, etc.) vendor/bin/typo3 imagecompression:compressImages --include-processed # Retry failed compressions vendor/bin/typo3 imagecompression:compressImages --retry-errors # Combine options vendor/bin/typo3 imagecompression:compressImages 200 --include-processed --retry-errors ``` Argument/OptionDescription`limit`Number of images to process (default: 100)`--include-processed`, `-p`Also compress processed files (thumbnails, crops). By default, only original files are compressed to save API quota.`--retry-errors`, `-r`Retry compression for files that previously failed. On success, the error status is cleared.Tip When using **Tinify** (TinyPNG API), we recommend **not** using `--include-processed` to conserve your API quota. Processed files are regenerated from the already-compressed originals. Important Before running the CLI command, ensure your TYPO3 file index is up to date. Use the scheduler task **"File Abstraction Layer: Update storage index"** to update the index. ### System Information Toolbar [](#system-information-toolbar) The extension displays the current API usage (TinyPNG) or compression statistics in the TYPO3 backend toolbar. ### Status Report [](#status-report) A detailed compression report is available in **Admin Tools > System Reports**. It shows the active provider, compression statistics for original and processed files, and API usage for TinyPNG. ### File Metadata [](#file-metadata) The compression status of individual files is displayed in the file metadata form (sys\_file\_metadata). Edit a file's metadata to see whether it has been compressed, and any error messages if compression failed. 💛 Acknowledgements ------------------ [](#-acknowledgements) This project is a fork and further development of the great [tinyimg](https://github.com/schmitzal/tinyimg) extension. 🧑‍💻 Contributing ---------------- [](#‍-contributing) Please have a look at [`CONTRIBUTING.md`](CONTRIBUTING.md). ⭐ License --------- [](#-license) This project is licensed under [GNU General Public License 2.0 (or later)](LICENSE.md). ### Health Score 45 — FairBetter than 93% of packages Maintenance81 Actively maintained with recent releases Popularity21 Limited adoption so far Community10 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 78.3% 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 Unknown Total 1 Last Release 164d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f71257bb4db7f3adcabdc7d93e0f84c00aa50689b1411976b57f6a57ed7b6b2e?d=identicon)[move-elevator](/maintainers/move-elevator) --- Top Contributors [![konradmichalik](https://avatars.githubusercontent.com/u/4558190?v=4)](https://github.com/konradmichalik "konradmichalik (47 commits)")[![Mainbird](https://avatars.githubusercontent.com/u/16002519?v=4)](https://github.com/Mainbird "Mainbird (12 commits)")[![revoltek-daniel](https://avatars.githubusercontent.com/u/5931272?v=4)](https://github.com/revoltek-daniel "revoltek-daniel (1 commits)") --- Tags image-compressiontinifytypo3typo3-extensionimageImageMagickcompressionoptimizationtypo3typo3-extensiontinypngjpegoptim ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/move-elevator-typo3-image-compression/health.svg) ``` [![Health](https://phpackages.com/badges/move-elevator-typo3-image-compression/health.svg)](https://phpackages.com/packages/move-elevator-typo3-image-compression) ``` ### Alternatives [ps/image-optimizer Image optimization / compression library. This library is able to optimize png, jpg and gif files in very easy and handy way. It uses optipng, pngquant, pngcrush, pngout, gifsicle, jpegoptim and jpegtran tools. 9341.7M25](/packages/ps-image-optimizer)[typo3/testing-framework The TYPO3 testing framework provides base classes for unit, functional and acceptance testing. 675.0M775](/packages/typo3-testing-framework)[schmitzal/tinyimg Image compression for all pngs and jpgs uploaded to the backend (using the tinypng API) 16125.5k](/packages/schmitzal-tinyimg)[christophlehmann/imageoptimizer Optimize uploaded/processed images with binaries of your choice 46501.8k](/packages/christophlehmann-imageoptimizer)[pagemachine/typo3-formlog Form log for TYPO3 23225.3k6](/packages/pagemachine-typo3-formlog)[eliashaeussler/typo3-warming Warming - Warms up Frontend caches based on an XML sitemap. Cache warmup can be triggered via TYPO3 backend or using a console command. Supports multiple languages and custom crawler implementations. 20229.9k](/packages/eliashaeussler-typo3-warming) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)