--- title: 'Image Rotator' url: 'https://doc.brix.ch/celum_extensions/image_rotator' markdown: 'https://doc.brix.ch/celum_extensions/image_rotator.md' lang: en date: '2026-10-26' description: 'Technical documentation for the CELUM Extension "Image Rotator" – Software developed by brix' taxonomy: category: - docs --- [](#) [ Welcome ](https://doc.brix.ch/) [ CELUM Extensions ](https://doc.brix.ch/celum_extensions) Image Rotator # Image Rotator ![Advanced-UI](https://img.shields.io/static/v1?label=UI&message=Advanced&color=lightgrey)![NOVA-UI](https://img.shields.io/static/v1?label=UI&message=NOVA&color=blue) Plugin to rotate images and videos. The plugin has a large live preview. #### Table of Contents - [Properties](#properties) - [Docker](#docker) - [Screenshots](#screenshots) - [Compatibility Matrix](#compatibility-matrix) - [Release Notes](#release-notes) ## Properties To be configured in *{home}/appserver/conf/custom.properties*. ##### imageRotator.license > type: String, **required: yes**, default: - License key (delivered by brix Solutions AG) ##### imageRotator.allowedUserGroupIds= > type: List of long (comma-separated), required: no, default: - Restrict the use of the plugin to these user group IDs (superadmins always see it in any case). ##### imageRotator.commands.imageMagick.convert.exe= > type: String, **required: yes**, default: - Path to convert.exe (imageMagick tool) ##### imageRotator.commands.exiftool.exe= > type: String, **required: yes**, default: - Path to exiftool.exe ##### imageRotator.commands.jpegtran.exe= > type: String, required: no, default: - If the property is not set, imageMagick is used to rotate. > > > Rotating via jpegtran only works correctly for images with a certain height and width (see [here](https://stackoverflow.com/questions/14612809/jpegtran-exe-not-correctly-rotating-image)) Path to jpegtran.exe for Windows Installations (exe can be downloaded [here](https://jpegclub.org/jpegtran/)). For Linux, install it through `yum install libjpeg` or `apt install libjpeg-progs` respectively. Once installed it should be in /usr/bin/jpegtran For manual installation on Linux of the latest Version, download the files [here](http://www.ijg.org/files/), afterwards unpack it to a directory, for example /opt/celum/conversiontools/jpegtran, go to the directory that contains the uncompressed code, execute `./configure` and then, `make install`. Now you should find the executable as `jpegtran` in the directory. ##### imageRotator.whiteListOfImageFormatsForMetadataRotation= > type: String, required: no, default: jpg,jpeg,tif,tiff,dng,mp4,mov,m4v Whitelist of image formats for meta-data rotation ##### imageRotator.whiteListOfImageFormatsForToolRotation= > type: String, required: no, default: png Whitelist of image formats for tool rotation ##### imageRotator.autoRotationFix= > type: Boolean, required: no, default: false AutoFix of images with orientation number 5 & 7 , if enabled ##### imageRotator.uploadNodeId= > type: int, required: no, default: - NodeId for upload when adding as new asset. When not set, the asset is uploaded to the same node as the original asset. ##### imageRotator.videoFormats= > type: String, required: no, default: mp4,mov,m4v Supported video formats. ## Docker As the conversion tools need to be accessible to the appserver, you'll need to mount them into the docker image using volume-mounts: ``` - /usr/local/bin/convert:/usr/local/bin/convert:r - /usr/local/bin/jpegtran:/usr/bin/jpegtran:r - /usr/local/bin/exiftool:/usr/bin/exiftool:r ``` Furthermore, `exiftool` will not just work out of the box, as it expects `perl` etc. to be available, you can't just mount it directly. Use `pp` (`apt install libpar-packer-perl`) to package it: `pp -o /usr/local/bin/exiftool /usr/bin/exiftool` - not that it is important to do this on the same distro/version as used inside (Ubuntu 22.04 at the time of writing) ## Screenshots ![imageRotator1](https://doc.brix.ch/user/pages/01.celum_extensions/33.image_rotator/imageRotator1.PNG)![imageRotator2](https://doc.brix.ch/user/pages/01.celum_extensions/33.image_rotator/imageRotator2.PNG)![imageRotator3](https://doc.brix.ch/user/pages/01.celum_extensions/33.image_rotator/imageRotator3.PNG)![imageRotatorAssetVersions](https://doc.brix.ch/user/pages/01.celum_extensions/33.image_rotator/imageRotatorAssetVersions.PNG) ## Compatibility Matrix | Image Rotator | CELUM (min. version) | |---|---| | 2.10.0 | 5.13.3 (tested with 6.8) | | 2.11.0 | 5.13.3 (tested with 6.11) | | 2.12.0 | 5.13.4 (tested with 6.11) | | Nova Plugin | CELUM (min. version) | Backend Plugin (min. version) | |---|---|---| | 1.0.0-6.11.0 | 6.11.0 | 2.12.0 | | 1.0.0-6.12.0 | 6.12.0 | 2.12.0 | ## Release Notes #### 1.0.0 > Released 04.01.2019 Initial Version #### 1.1.0 > Released 11.01.2019 Various changes on GUI and refactoring #### 1.2.0 > Released 15.02.2019 - rotate through metadata manipulation - added a selection to choose the kind of rotation - added whitelist property to set imageformats for which rotation - various changes on GUI #### 2.0.0 > Released 15.02.2019 - big refactoring of the internal structure with bug fixes #### 2.1.0 > Released 07.03.2019 - new transform functionality - refactoring #### 2.2.0 > Released 18.03.2019 - minor refactoring #### 2.3.0 > Released 22.03.2019 - added AssetReleased Listener for jpegtran & imagemagick - added AssetVersionAdded Listener for jpegtran & imagemagick #### 2.4.0 > Released 27.03.2019 - autoRotate of images with EXIF Orientation 5 or 7 #### 2.5.0 > Released 05.04.2019 - added anti-clockwise rotation #### 2.6.0 > Released 05.04.2019 - added selection to choose upload format (new asset or new asset version) #### 2.7.0 > Released 08.04.2019 - upload to all direct parent node's if nodeIdToUpload is null #### 2.8.0 > Released 26.04.2019 - new calculation method of orientation number - refactoring #### 2.9.0 > Released 02.05.2019 - added validation check before rotate - added default settings #### 2.10.0 > Released 25.02.2021 - added license check - changed property jpegtran from required to not required #### 2.11.0 > Released 16.12.2021 - added video rotation - tool rotation only for png #### 2.12.0 > Released 20.01.2022 - Nova Plugin Backend [ ](https://doc.brix.ch/celum_extensions/relation_marker) [](https://doc.brix.ch/celum_extensions/custom_previews) --- ## Navigation - Parent: [CELUM Extensions](https://doc.brix.ch/celum_extensions.md) - Previous: [Relation Marker](https://doc.brix.ch/celum_extensions/relation_marker.md) - Next: [Custom Previews](https://doc.brix.ch/celum_extensions/custom_previews.md)