PHPackages                             spacecatninja/imager-x-imageboss-transformer - 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. spacecatninja/imager-x-imageboss-transformer

ActiveCraft-plugin[Image & Media](/categories/media)

spacecatninja/imager-x-imageboss-transformer
============================================

ImageBoss transformer for Imager X

3.0.1(1y ago)23192[3 issues](https://github.com/spacecatninja/craft-imager-x-imageboss-transformer/issues)1MITPHPPHP ^8.0

Since Aug 22Pushed 1y ago1 watchersCompare

[ Source](https://github.com/spacecatninja/craft-imager-x-imageboss-transformer)[ Packagist](https://packagist.org/packages/spacecatninja/imager-x-imageboss-transformer)[ RSS](/packages/spacecatninja-imager-x-imageboss-transformer/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (1)Versions (8)Used By (1)

ImageBoss transformer for Imager X
==================================

[](#imageboss-transformer-for-imager-x)

A plugin for using [ImageBoss](https://imageboss.me/) as a transformer in Imager X.
Also, an example of [how to make a custom transformer for Imager X](https://imager-x.spacecat.ninja/extending.html#transformers).

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 5.0.0-beta.1 or later, [Imager X 5.0.0-beta.1](https://github.com/spacecatninja/craft-imager-x/) or later, and an account at [ImageBoss](https://imageboss.me/).

Usage
-----

[](#usage)

Install and configure this transformer as described below. Then, in your [Imager X config](https://imager-x.spacecat.ninja/configuration.html), set the transformer to `imageboss`, ie:

```
'transformer' => 'imageboss',

```

Transforms are now by default transformed with ImageBoss, test your configuration with a simple transform like this:

```
{% set transform = craft.imagerx.transformImage(asset, { width: 600 }) %}

URL is: {{ transform.url }}

```

If this doesn't work, make sure you've configured a `defaultProfile`, have a profile with the correct name, and that the source is set up to use the same buckets that you assets are on.

### Cave-ats, shortcomings, and tips

[](#cave-ats-shortcomings-and-tips)

This transformer only supports a subset of what Imager X can do when using the default `craft` transformer. All the basic transform parameters are supported, with the following exceptions:

- Only assets can be transformed. If you need to transform external images, you need to switch to the `craft` transformer for those transforms.
- The `cropOnly` and `stretch` resize modes are not supported.
- Opacity for colors on `letterbox` resize mode is not supported.
- Only the following `effects` are converted and supported: `grayscale`, `sharpen`, `blur` and `gamma`. – Watermarks are not translated automatically from Imager syntax to ImageBoss', but you can still add watermarks by manually passing them through the `options` object (see below).

To pass additional options directly to ImageBoss, you can use the `transformerParams` transform parameter and pass them in using an `options` object. Example:

```
{% set transforms = craft.imagerx.transformImage(asset,
    [{width: 400}, {width: 600}, {width: 800}],
    { ratio: 2/1, transformerParams: { options: 'sharpen:6,grayscale:true' } }
) %}

```

For more information, check out the [ImageBoss documentation](https://imageboss.me/docs).

Installation
------------

[](#installation)

To install the plugin, follow these instructions:

1. Install with composer via `composer require spacecatninja/imager-x-imageboss-transformer` from your project directory.
2. Install the plugin in the Craft Control Panel under Settings > Plugins, or from the command line via `./craft plugin/install imager-x-imageboss-transformer`.

Configuration
-------------

[](#configuration)

You can configure the transformer by creating a file in your config folder called `imager-x-imageboss-transformer.php`, and override settings as needed.

### profiles \[array\]

[](#profiles-array)

Default: `[]`
Profiles are usually a one-to-one mapping to the [image sources](https://imageboss.me/docs#image-sources) you've created in ImageBoss. Which in turn will often map to a Volume in your Craft setup. You set the default profile to use using the `defaultProfile` config setting, and can override it at the template level by setting `profile` in your `transformerParams`.

Example profile:

```
'profiles' => [
    'default' => [
        'sourceName' => 'imagerx-s3',
        'signToken' => '7a7cc5142212378b435edb18b273bec8799e1270272cc49f34836651cd023a28',
        'useCloudSourcePath' => true,
    ],
    'web' => [
        'sourceName' => 'imagerx-web',
        'signToken' => '1b7ca41421125791a31edb18a273bec8792e1970272ad49f34836631cd023a28',
        'useCloudSourcePath' => false,
    ]
],

```

Each profile takes three settings:

*sourceName*: This is the "Source Name" you selected in ImageBoss.

*signToken*: If you've enabled signed URL's for security, add your sign token here.

*useCloudSourcePath*: If enabled, Imager will prepend the Craft source path to the asset path, before adding it to the ImageBoss URL. This makes it possible to have one ImageBoss source pulling images from many Craft volumes when they are for instance on the same S3 bucket, but in different subfolder. This only works on volumes that implements a path setting (AWS S3 and GCS does, local volumes does not).

### defaultProfile \[string\]

[](#defaultprofile-string)

Default: `''`
Sets the default profile to use (see `profiles`). You can override profile at the transform level by setting it through the `transformParams` transform parameter. Example:

```
{% set transforms = craft.imagerx.transformImage(asset,
    [{width: 800}, {width: 2000}],
    { transformerParams: { profile: 'myotherprofile' } }
) %}

```

### enableCompression \[bool\]

[](#enablecompression-bool)

Default: `true`
Set to `false`to disable ImageBoss' [default auto compression](https://imageboss.me/docs/image-compression) that delivers WebP automatically when the browser supports it.

### enableProgressive \[bool\]

[](#enableprogressive-bool)

Default: `true`
Set to `false`to disable ImageBoss' [default behavior](https://imageboss.me/docs/progressive-images) that delivers progressive JPEG's when possible.

### enableAutoRotate \[bool\]

[](#enableautorotate-bool)

Default: `true`
Set to `false`to disable ImageBoss' [default behavior](https://imageboss.me/docs/auto-rotate) that uses EXIF data in the image to auto rotate it.

Price, license and support
--------------------------

[](#price-license-and-support)

The plugin is released under the MIT license. It requires Imager X, which is a commercial plugin [available in the Craft plugin store](https://plugins.craftcms.com/imager-x). If you need help, or found a bug, please post an issue in this repo, or in Imager X' repo (preferably).

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance12

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~171 days

Recently: every ~194 days

Total

7

Last Release

696d ago

Major Versions

v1.x-dev → 2.0.02022-05-03

2.0.0 → 3.0.02024-02-10

### Community

Maintainers

![](https://www.gravatar.com/avatar/806fbb515be53ddbca1d658f1abe7f8ddd41d77b72eec8aa85800db3a03e7e35?d=identicon)[spacecatninja](/maintainers/spacecatninja)

---

Top Contributors

[![aelvan](https://avatars.githubusercontent.com/u/2675644?v=4)](https://github.com/aelvan "aelvan (7 commits)")

---

Tags

imagecmstransformresponsiveCraftcraftcmscraft-pluginpicturesrcsetimageboss

### Embed Badge

![Health badge](/badges/spacecatninja-imager-x-imageboss-transformer/health.svg)

```
[![Health](https://phpackages.com/badges/spacecatninja-imager-x-imageboss-transformer/health.svg)](https://phpackages.com/packages/spacecatninja-imager-x-imageboss-transformer)
```

###  Alternatives

[spacecatninja/imager-x

Ninja powered image transforms.

29390.0k23](/packages/spacecatninja-imager-x)[nystudio107/craft-imageoptimize

Automatically create & optimize responsive image transforms, using either native Craft transforms or a service like imgix, with zero template changes.

232337.2k16](/packages/nystudio107-craft-imageoptimize)[nystudio107/craft-youtubeliveembed

This plugin allows you to embed a YouTube live stream and/or live chat on your webpage

163.7k](/packages/nystudio107-craft-youtubeliveembed)

PHPackages © 2026

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