# ResourceSpace - Video tracks plugin configuration

This plugin allows users to create custom video files by using subtitle and audio track files that have been uploaded as alternative files for a video resource.

Because the processing of video files can take time the plugin utilises new job queue functionality so that the file creation can take place offline. The plugin options page allows for a size limit to be configured and video files that are larger than this will be added to the queue. Once the processing is complete the user will be sent a system notification that the file is available

## Setup instructions.

To enable the offline functionality the ‘$offline_job_queue’ configuration option must be enabled in config.php as below. A scheduled task/cron job should also be configured to run the pages/tools/offline_jobs.php as frequently as desired.

$offline_job_queue=true;

1. Enable the video_tracks plugin via Admin->System->Manage plugins->Asset processing
2. Set the plugin configuration as required as below

#### Option | #### Description
Automatically convert subrip subtitle files (.srt) to VTT to allow display in video previews? | This should be enabled if you want to be able to preview subtitles in the VideoJS player and is required because SRT files are no longer supported. Note that the previews will only work if MP4 video previews are used and will not work with FLV previews.
Show the custom video option for these file extensions | The ‘create custom video’ link will only appear for resources with these extensions
List of alternative file audio extensions (comma separated) that can be used for soundtrack | As option indicates, these are the audio file formats that can be used to create the custom video
List of permitted subtitle file extensions (comma separated). Must be supported by ffmpeg | Similar to above.
Maximum size of resource file that will be processed immediately (MB). Larger files will be processed offline and the user notified upon completion | This option depends on offline processing being enabled ( $offline_job_queue=true;)
Export folder to save generated videos | Server path to a folder that the exported files will be saved to. The standard download filename will be used with an optional timestamp to prevent overwriting.
When files are created in the export folder offline, add a link to notification messages allowing for download of exported files through web interface | If set to true and an exported file is created offline the notification message sent to the user will include a link to download the embedded file without having to navigate to the folder location
Available file output options. These should be tested on the server to ensure the syntax is correct for your installation of ffmpeg/avconv | This requires some technical knowledge. This allows you to construct the basic ffmpeg/avconv command syntax that will be used to create the custom videos from the selected inputs. You can set these up to meet your requirements and assign friendly names to them e.g. ‘Website preview’. It is advisable to test the command on the server to make sure you are happy with the results.