Confluence Media Processor Documentation

Owned by Filip Minic
Last updated: Jan 31, 2024 by Stefan Grüll
6 min read

Features

  • Convert images and videos to your preferred resolution and modern format

  • Drag and drop interface for converting media files

  • Remote fast central conversion process using FFmpeg and ImageMagick

 

Installation quick guide

1. Download the Confluence Media Processor in Confluence

  • Minimum compatible Confluence version: see marketplace information for your specific Confluence Media Processor version

  • Click on the cog icon

    • Go to “Manage Apps”

    • Go to “Find new Apps”

    • Enter “Confluence Media Processor“ and click on install

2. Install requirements


(Contact your server administrator to install FFmpeg and ImageMagick on the Confluence Server, if you have no access rights to it.)

IMPORTANT:Theses two binaries have to be installed on every node on the same path if you are using Confluence Data Center!

 

How to install FFmpeg

How to install it on Ubuntu 18.04 or Ubuntu 20.04:

  • Run sudo apt-get update

  • Run sudo apt-get install ffmpeg

  • Run sudo -u confluence ffmpeg -version where 'confluence' is the service user for your confluence installation

  • If it looks like this, you are finished:

  • Type which ffmpeg (normally this returns /usr/bin/ffmpeg) and note this path, you need it later.

How to install it on Windows Server:

  • Download https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-full.7z

  • Extract it to YOUR_INSTALL_DIR\ffmpeg-4.4-full_build where e.g. YOUR_INSTALL_DIR = C:\Program Files

  • Make sure the executing user of confluence can read this directory (Username is usually confluence).

  • You can add the executing user of confluence to the directory ACL by right-click and properties on the directory ffmpeg-4.4-full_build

  • Click on edit:

     

  • Click on add:

     

  • Type the execution user of confluence and click on “Check Names”

     

  • Click on ok.

  • Note the path YOUR_INSTALL_DIR\ffmpeg-4.4-full_build\bin\ffmpeg.exe

How to install it on CentOS 7 or CentOS 8:

How to install ImageMagick

HEIF Support: Note that ImageMagick on Linux systems does not automatically support HEIF encoded files. If you need to convert images or videos of this format you have to build ImageMagick from source with the corresponding flag to use heic. In case you have any troubles doing that, please contact us at support@celix.at.

How to install it on Ubuntu 18.04 or Ubuntu 20.04:

  • Run sudo apt-get update

  • Run sudo apt-get install imagemagick

  • Run sudo -u confluence convert -version where 'confluence' is the service user for your confluence installation

  • If it looks like this, you are finished:

  • Type which convert (normally this returns /usr/bin/convert) and note this path, you need it later.

How to install it on Windows Server:

  • Download

  • Extract it to C:\Program Files\ImageMagick-7.1.1-27-portable-Q16-x64

  • Make sure the executing user of confluence can read this directory (Username is usually confluence).

  • You can add the executing user of confluence to the directory ACL by right-click and properties on the directory ImageMagick-7.1.1-27-portable-Q16-x64

  • Click on edit:

  • Click on add:

  • Type the execution user of confluence and click on “Check Names”

  • Click on ok.

  • Note the path C:\Program Files\ImageMagick-7.1.1-27-portable-Q16-x64\convert.exe

How to install it on CentOS 7:

How to install it on CentOS 8:

3. Configure the add-on

After installation of the plugin and prerequisites, go to the Add-ons section and find the Confluence Media Processor Macro Link

  • Enter your global configuration settings, these will be used to convert all the media in the macro. Here you can define:

    • The absolute path to FFmpeg and ImageMagick (used for the conversion process) - use previous determined paths.

    • The maximum video height (to which all videos will be converted to).

    • The length of the lon
      gest image edge (the length of the edge above which images should be scaled down to).

    • Whether to remove metadata from the media files during conversion.

Click on save.

4. Installation finished

Further information for Prerequisites

Usage in Confluence 6.15.X

To use the macro you need to include it in a page where the data should be saved. You can select whether metadata should be striped, kept or if the global configuration should be used.

 

  • You can then use the drag and drop interface on the page to upload your desired media files, these will be converted and appear as attachments once the conversion process is done. If the files have the same name and extension as existing files they will appear as new versions.