Enable video conversion

With the release of version 12.0, IXM One can automatically enhance video uploads to ensure optimal quality and compatibility. When a video is uploaded, the system evaluates the file format and codec. If it does not meet the expected standards, it's automatically converted without the need for additional manual intervention.

How it works

The video conversion process works via spot groups and requires the following steps:

• Create spot groups for video conversion in IXM One and get their IDs. We recommend clear and descriptive spot group names to ensure easy identification.

• Enable and configure video conversion.

• Control user access to the selected spot groups in IXM One using write permissions.

Limitations

Note the following limitations of the video conversion feature:

• This feature applies exclusively to video files. It doesn’t support other formats like images, PDFs, or website spots.

• By default, there is no visual indication to users showing which spot groups have the automatic video conversion feature enabled. Use descriptive spot group names for easy identification.

Get spot group IDs

You need the spot group IDs to configure in which spot groups uploaded videos are automatically converted.

To get the spot group IDs, perform the following steps:

1. In IXM One, go to Content > Playlist.

2. In the Spot groups pane, double-click on the spot group that you want to use for video conversion.

3. Open the Developer Tools in your browser. For example, in Google Chrome go to Customize and control Google Chrome > More Tools > Developer Tools.

4. In the Developer Tools window, select the Network tab.

5. Read the ID from the list and write it down. You’ll need it to configure video conversion.

6. Repeat these steps to get the IDs of other spot groups if needed.

Enable video conversion

To enable automatic video conversion, perform the following steps:

1. Open the master.config file on the server with a text editor like Notepad++.

2. Configure the following settings as needed:

   Setting	Default	Description
   SpotGroupVideoConversion:{SpotGroupId}:argumentsTemplate	null	Specifies FFmpeg arguments to convert the video. Example: -i @@input@@ -c:v libx264 -crf 18 -preset ultrafast -c:a copy @@output@@ For more information on FFmpeg arguments, see the FFmpeg documentation.
   SpotGroupVideoConversion:{SpotGroupId}:extension	.mp4	Specifies the file extension of the output file. You can use any format that FFmpeg supports. For more information, see the FFmpeg documentation.
   FfmegExeFullpath	MAINSERVERPATH/Tools/ffmpeg/ffmpeg.exe	Specifies the absolute path to the FFmpeg executable. This value should not be changed.

3. Make sure to replace {SpotGroupId} with the spot group ID.

4. Optionally, specify more than one spot group by adding and configuring SpotGroupVideoConversion:{SpotGroupId}:argumentsTemplate multiple times.

5. Save your changes and close the file.

Example configuration

<add key="SpotGroupVideoConversion:123:argumentsTemplate" value="-i @@input@@ -c:v libx264 -crf 18 -preset ultrafast -c:a copy @@output@@" />
<add key="SpotGroupVideoConversion:378:argumentsTemplate" value="-i @@input@@ -c:v libx264 -crf 18 -preset slow -c:a copy @@output@@" />
<add key="SpotGroupVideoConversion:123:extension" value=".mp4" />
<add key="FfmegExeFullpath" value="MAINSERVERPATH/Tools/ffmpeg/ffmpeg.exe" />