PHPackages                             gesagtgetan/krakenoptimizer - 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. gesagtgetan/krakenoptimizer

ActiveNeos-plugin[Image &amp; Media](/categories/media)

gesagtgetan/krakenoptimizer
===========================

Image optimizer for Neos utilizing the Kraken API

3.0.0(6y ago)4732[1 PRs](https://github.com/gesagtgetan/GesagtGetan.KrakenOptimizer/pulls)PHP

Since Apr 23Pushed 6y ago4 watchersCompare

[ Source](https://github.com/gesagtgetan/GesagtGetan.KrakenOptimizer)[ Packagist](https://packagist.org/packages/gesagtgetan/krakenoptimizer)[ RSS](/packages/gesagtgetan-krakenoptimizer/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (3)Versions (22)Used By (0)

---

GesagtGetan.KrakenOptimizer
---------------------------

[](#gesagtgetankrakenoptimizer)

Image optimizer for Neos utilizing the Kraken API

VersionNeos1.x2.3 LTS2.x3.x, 4.x3.x5.xInstallation
------------

[](#installation)

```
composer require gesagtgetan/krakenoptimizer

```

Create a Kraken account on [https://kraken.io](https://kraken.io/?ref=a6246f4dd262) and generate new API Keys on .

Add the credentials to your global `Settings.yaml`:

```
GesagtGetan:
  KrakenOptimizer:
    krakenOptions:
      auth:
        api_key: ''
        api_secret: ''

```

Usage
-----

[](#usage)

#### Warning:

[](#warning)

> ⚠ As with any plugin that actively works on your database and resources it is a good idea to make sure you keep regular backups for your website. No known disasters have been caused by this plugin, but it's always better to be safe than sorry.

1. We usually want to optimize all existing resources. We can do this by running this CLI command

```
./flow kraken:optimize

```

All existing thumbnails will be replaced by optimized version from Kraken. By default we perform `lossy` optimizations, because this can dramatically decrease image size, while no noticeable decrease in image quality should occur. You can change the optimization strategy by altering the `krakenOptions` in the settings (set `lossy: false`), along with other arbitrary Kraken API options (see ).

#### Tip:

[](#tip)

In case something goes wrong during the initial optimization, it's possible to resume optimization from a preferred offset. For example `./flow kraken:optimize --offset 300` will skip the first 299 thumbnails.

#### Warning:

[](#warning-1)

> ⚠ Executing this command multiple times will send potentially already optimized images to the Kraken API and thus will still count towards your API quota and can lead to "over optimized" images when running lossy optimizations multiple times.

2. Now is the perfect time to activate live optimizations. All generated thumbnails after the initial optimiziation will be send to kraken for improvement when this flag is set:

```
GesagtGetan:
  KrakenOptimizer:
    liveOptimization: true
```

> ♻ Don't forget to flush your caches after adding the flag in a production environment.

3. Delete Production cache

```
FLOW_CONTEXT=Production ./flow flow:cache:flush

```

Additional options
------------------

[](#additional-options)

### optimizeOriginalResource

[](#optimizeoriginalresource)

By enabling the `optimizeOriginalResource` flag, the original image will be replaced with an optimized version, if no thumbnail creation was necessary for a particular image. Neos will not create a thumbnail for an image, if the the necessary dimensions are equal or lower than the original image.

By default we do not optimize original images. Make sure you have regular backups of your server, in case something goes wrong during optimization!

#### Usage:

[](#usage-1)

```
GesagtGetan:
  KrakenOptimizer:
    optimizeOriginalResource: true
```

Troubleshooting and FAQ
-----------------------

[](#troubleshooting-and-faq)

**Q: I already optimized my thumbnails before installing this plugin, but I'm unhappy with the result**

A: If your thumbnails already show signs of high compression like artefacts, this plugin can not restore that missing information. In that case it's necessary to clear all your existing thumbnails with `./flow media:clearthumbnails`. Be aware that this can put a lot of load on your server since all thumbnails need recreation, when a page has been called. You can activate `liveOptimization` right away, or optimize the created thumbnails later by running `./flow kraken:optimize`.

If you need all your thumbnails in all your preset sizes, you can pre-generate them by running `./flow media:createthumbnails` and `./flow media:renderthumbnails`. Either optimize afterwads or have `liveOptimization` activated.

###  Health Score

33

—

LowBetter than 74% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 97.4% 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

Every ~36 days

Recently: every ~92 days

Total

19

Last Release

2285d ago

Major Versions

1.1.1 → 2.1.12018-05-14

1.1.2 → 2.2.02018-07-27

1.1.3 → 2.2.12019-02-01

1.0.x-dev → 2.2.22019-02-01

2.2.2 → 3.0.02020-02-05

### Community

Maintainers

![](https://www.gravatar.com/avatar/e08f7fdd8ca37d2d6dde0ee6bcf730527a190e2cd25ab4f37a79b09ed273cc61?d=identicon)[gesagt.getan.](/maintainers/gesagt.getan.)

---

Top Contributors

[![gerhard-boden](https://avatars.githubusercontent.com/u/10533739?v=4)](https://github.com/gerhard-boden "gerhard-boden (147 commits)")[![flammel](https://avatars.githubusercontent.com/u/3888?v=4)](https://github.com/flammel "flammel (4 commits)")

---

Tags

imagekrakenneoscmsoptimizerpackage

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/gesagtgetan-krakenoptimizer/health.svg)

```
[![Health](https://phpackages.com/badges/gesagtgetan-krakenoptimizer/health.svg)](https://phpackages.com/packages/gesagtgetan-krakenoptimizer)
```

###  Alternatives

[opentok/opentok

OpenTok is a platform for creating real time streaming video applications, created by TokBox.

1413.0M10](/packages/opentok-opentok)[automattic/wistia-php

PHP wrapper for Wistia API

1431.9k](/packages/automattic-wistia-php)[daun/statamic-placeholders

Generate low-quality image placeholders for lazyloading Statamic assets

106.6k](/packages/daun-statamic-placeholders)[daun/statamic-mux

Seamless video encoding and streaming using Mux on Statamic sites

132.3k](/packages/daun-statamic-mux)

PHPackages © 2026

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