About: Upload files to your LTN Schedule instance using SFTP to make them available within the library and use them inside your rundown.
Where can I find the SFTP Credentials
SFTP User and Password to upload media to LTN Schedule can be found in the User Tab from Version 9.2.x on:
For older versions you receive(d) your SFTP user and password within the system provisioning process.
Upload media via SFTP
To upload media files via SFTP:
Configure your external SFTP upload client using the credentials provided specifically to your LTN Schedule instance. SFTP credentials are provided within your LTN Schedule system under Users.
Each video file must have a related XML metadata sidecar file using the same name as the related video file. For example:
test1234.mp4 <-- video file
test1234.xml <-- metadata file
For Schedule version 9.2.x and higher, you may use the following template for your metadata sidecar files:
From version 10.1.02, you can also use <trimIn> and <trimOut> as shown in the example.
<?xml version="1.0" encoding="UTF-8"?>
<videoFile xmlns="http://www.ltnschedule.com/upload">
<title><![CDATA[Custom Video Title]]></title>
<description><![CDATA[Customer Video Description]]></description>
<tags>
<tag><![CDATA[tag 1]]></tag>
<tag><![CDATA[tag 2]]></tag>
<tag><![CDATA[tag 3]]></tag>
</tags>
<adTriggers>
<adTrigger>
<triggerTime>10000</triggerTime> <!-- time in milliseconds -->
<adLength>30000</adLength> <!-- time in milliseconds -->
<adType>national</adType>
</adTrigger>
<adTrigger>
<triggerTime>80000</triggerTime> <!-- time in milliseconds -->
<adLength>30000</adLength> <!-- time in milliseconds -->
<adType>local</adType>
</adTrigger>
<adTrigger>
<triggerTime>120000</triggerTime> <!-- time in milliseconds -->
<adLength>30000</adLength> <!-- time in milliseconds -->
</adTrigger>
</adTriggers>
<customKeys>
<customKeyData>
<key><![CDATA[Custom Field 1 example]]></key>
<value><![CDATA[test]]></value>
</customKeyData>
<customKeyData>
<key><![CDATA[Custom Field 2 example]]></key>
<value><![CDATA[test2]]></value>
</customKeyData>
</customKeys>
<trimIn>1000</trimIn>
<trimOut>2000</trimOut>
</videoFile>
Setting up Title, Description & Tags in the XML File:
The bold text from above within the CDATA brackets "Customer Video Title" and "Customer Video Description" should be replaced by the actual media file title and description.
You can also hand over tags (that you can later filter in the library). Add those tags in the <tag> section.
The field adType describes the type of SCTE-trigger that will be sent (on compatible push targets, if the SCTE-triggers feature is enabled on the system).
File Naming:
The .xml file should have the same name as the media (.mp4 or .ts) file. So if the media file name is media.mp4, the xml file should have the name media.xml.
Folders to upload media- and xml-file to:
The final .xml file must be uploaded together with the actual media file (.mp4 or .ts) into the /DATA folder via SFTP. Once both files are uploaded completely, the system will process the file and take the information (Title & Description) out of the corresponding .xml file. The system will always wait for processing until both files are uploaded completely.
If you can not provide XML files with additional metadata prepared, please upload your files into the “no_xml_import” folder. LTN Schedule will automatically generate a valid XML file based on the name of the files and process this file even without an additional meta data xml.
If the system cannot import your updated files, the files will remain within the DATA folder, together with an error message that shows the reason why the import cannot be processed.