PHPackages                             twoh/twoh\_tiny\_png - 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 &amp; Media](/categories/media)
4. /
5. twoh/twoh\_tiny\_png

ActiveTypo3-cms-extension[Image &amp; Media](/categories/media)

twoh/twoh\_tiny\_png
====================

Optimize your TYPO3 Images using the TinyPNG API

1.0.9(4mo ago)0251GPL-2.0-or-laterPHPPHP &gt;=8.2 &lt;8.4CI failing

Since Dec 7Pushed 3mo agoCompare

[ Source](https://github.com/twohreichel/twoh_tiny_png)[ Packagist](https://packagist.org/packages/twoh/twoh_tiny_png)[ GitHub Sponsors](https://github.com/twohreichel)[ RSS](/packages/twoh-twoh-tiny-png/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (6)Versions (4)Used By (1)

🐼 TinyPNG TYPO3 Extension
=========================

[](#-tinypng-typo3-extension)

> Optimize your TYPO3 images automatically using the TinyPNG API

[![TYPO3 12](https://camo.githubusercontent.com/08afacc49187e63c796f7d1c4401d0f0563bab574d9c525312b2827acb09a7c5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31322d6f72616e67652e737667)](https://get.typo3.org/version/12)[![TYPO3 13](https://camo.githubusercontent.com/149184b6e5176a0c630a43a287c9e6bf1378e1613e96e567c2dcc13b5636205a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d31332d677265656e2e737667)](https://get.typo3.org/version/13)[![PHP 8.x](https://camo.githubusercontent.com/21f48905dfb14a1e57771e1eb9f7198704b9b463216a99f989996f272cb23443/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e782d626c75652e737667)](https://www.php.net/)[![License: GPL v2](https://camo.githubusercontent.com/77e900ae34f8da9ccccc42662fce61a94ab07ddbfe3f7d066178e824f3673dbd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d47504c25323076322d626c75652e737667)](https://www.gnu.org/licenses/gpl-2.0)

---

📋 Requirements
--------------

[](#-requirements)

RequirementVersionPHP&gt;= 8.2Composer&gt;= 2.4TYPO313.x---

🔑 Get Your TinyPNG API Key
--------------------------

[](#-get-your-tinypng-api-key)

1. Visit [TinyPNG Developers](https://tinypng.com/developers)
2. Enter your **Full Name**
3. Enter your **E-Mail**
4. Receive your **API Key**

---

🚀 Installation &amp; Setup
--------------------------

[](#-installation--setup)

### Extension Setup

[](#extension-setup)

1. Install the extension via Composer:

    ```
    composer require twoh/twoh_tiny_png
    ```
2. Include the extension in your TypoScript **ROOT Template**
3. Configure the following TypoScript settings:

    - Set your **API Key**
    - Create a **Backend folder** for TinyPNG records
    - Set the **PID** of your backend folder
    - *(Optional)* Set **Width** for image resizing on upload (height is calculated automatically)

### Scheduler Setup (Bulk Optimization)

[](#scheduler-setup-bulk-optimization)

1. Create a new Scheduler Task
2. Select **TinyPNG Bulk Compression Command**
3. Start the cron job

> ⚠️ **Note:** The cron may take longer depending on the number of images.

---

⚙️ Configuration
----------------

[](#️-configuration)

### Ignore Specific Folders

[](#ignore-specific-folders)

To exclude images from specific folders, add them to your TypoScript Constants (comma-separated):

```
ignoreImagesByFolderName = {$plugin.tx_twohtinypng.settings.ignoreImagesByFolderName}

```

### File Upload Process

[](#file-upload-process)

The extension hooks into the File Upload Process and automatically compresses images on upload.

---

🛠️ Development
--------------

[](#️-development)

### Code Quality with PHP CS Fixer

[](#code-quality-with-php-cs-fixer)

This extension uses PHP CS Fixer for code style enforcement following TYPO3 best practices.

CommandDescription`composer cs:fix`Auto-fix code style issues`composer cs:check`Check for violations (dry-run)---

👥 Authors
---------

[](#-authors)

NameRoleContactAndreas ReichelDeveloperIgor SmertinDeveloper---

📚 Documentation
---------------

[](#-documentation)

For detailed documentation, visit: [TYPO3 Documentation](https://docs.typo3.org/p/twoh/twoh_tiny_png/main/en-us/)

---

💖 Support This Project
----------------------

[](#-support-this-project)

If you find this extension helpful, please consider supporting its development! Your sponsorship helps maintain and improve this project.

[![Sponsor on GitHub](https://camo.githubusercontent.com/c0669ba9aa753cabceb9644a828bcf98075485e662660f8f346cf0b6e8b3094e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53706f6e736f722d2545322539442541342d7265643f6c6f676f3d676974687562)](https://github.com/sponsors/twohreichel)

Every contribution, no matter the size, is greatly appreciated and helps ensure the continued development of this extension. Thank you for your support! 🙏

---

🐛 Issues &amp; Support
----------------------

[](#-issues--support)

Found a bug or have a feature request? Please open an issue on [GitHub](https://github.com/twohreichel/twoh_tiny_png/issues).

---

📄 License
---------

[](#-license)

This project is licensed under the **GPL-2.0-or-later** license.

###  Health Score

40

—

FairBetter than 87% of packages

Maintenance82

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~6 days

Total

3

Last Release

142d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/910be78d7e68cfd2c6a88273375162664dfa6a8c96478fd336be892744546c63?d=identicon)[twoh](/maintainers/twoh)

---

Top Contributors

[![IgorSchubwerk](https://avatars.githubusercontent.com/u/111863465?v=4)](https://github.com/IgorSchubwerk "IgorSchubwerk (19 commits)")[![igorSmertinSchubwerk](https://avatars.githubusercontent.com/u/93521471?v=4)](https://github.com/igorSmertinSchubwerk "igorSmertinSchubwerk (9 commits)")[![twohreichel](https://avatars.githubusercontent.com/u/118019689?v=4)](https://github.com/twohreichel "twohreichel (8 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (2 commits)")[![arlschubwerk](https://avatars.githubusercontent.com/u/139746399?v=4)](https://github.com/arlschubwerk "arlschubwerk (1 commits)")

---

Tags

css3fluid-templatesphp8typo3typo3-cms-extensiontypo3-extensionwebdevelopmentimageoptimizationextensiontypo3tinypngbulk

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/twoh-twoh-tiny-png/health.svg)

```
[![Health](https://phpackages.com/badges/twoh-twoh-tiny-png/health.svg)](https://phpackages.com/packages/twoh-twoh-tiny-png)
```

###  Alternatives

[christophlehmann/imageoptimizer

Optimize uploaded/processed images with binaries of your choice

46501.8k](/packages/christophlehmann-imageoptimizer)[schmitzal/tinyimg

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

16125.5k](/packages/schmitzal-tinyimg)[somehow-digital/typo3-media-processing

Media Processing

101.1k](/packages/somehow-digital-typo3-media-processing)[webcoast/deferred-image-processing

Handles image processing on request instead of during page generation

1336.1k](/packages/webcoast-deferred-image-processing)[maxmirazh33/yii2-uploadable-cropable-image

Yii2 extension for upload and crop images

1020.8k](/packages/maxmirazh33-yii2-uploadable-cropable-image)

PHPackages © 2026

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