Skip to content

Latest commit

 

History

History
45 lines (32 loc) · 2.97 KB

import-export.md

File metadata and controls

45 lines (32 loc) · 2.97 KB

Import / Export

Customising exported file names

When exporting multiple segments as separate files, LosslessCut offers you the ability to specify how the output files will be named in sequence using a template string. The template string is evaluated as a JavaScript template string, so you can use JavaScript syntax inside of it. The following variables are available in the template to customize the filenames:

Avail when merging? Variable Output
${FILENAME} The original filename without the extension (e.g. Beach Trip for a file named Beach Trip.mp4).
${EXT} The extension of the file (e.g.: .mp4, .mkv).
${EPOCH_MS} Number of milliseconds since epoch (e.g. 1680852771465). Useful to generate a unique file name on every export to prevent accidental overwrite.
${SEG_NUM} Number of the segment, padded string (e.g. 01, 02 or 42).
${SEG_NUM_INT} Number of the segment, as a raw integer (e.g. 1, 2 or 42). Can be used with numeric arithmetics, e.g. ${SEG_NUM_INT+100}.
${SEG_LABEL} The label of the segment (e.g. Getting_Lunch).
${SEG_SUFFIX} If a label exists for this segment, the label will be used, prepended by -. Otherwise, the segment number prepended by -seg will be used (e.g. -Getting_Lunch, -seg1).
${CUT_FROM} The timestamp for the beginning of the segment in hh.mm.ss.sss format (e.g. 00.00.27.184).
${CUT_TO} The timestamp for the ending of the segment in hh.mm.ss.sss format (e.g. 00.00.28.000).
${SEG_TAGS.XX} Allows you to retrieve the tags for a given segment by name. If a tag is called foo, it can be accessed with ${SEG_TAGS.foo}. Note that if the tag does not exist, it will return the text undefined. You can work around this as follows: ${SEG_TAGS.foo ?? ''}

Your files must always include at least one unique identifer (such as ${SEG_NUM} or ${CUT_FROM}), and it should end in ${EXT} (or else players might not recognise the files). For instance, to achieve a filename sequence of Beach Trip - 1.mp4, Beach Trip - 2.mp4, Beach Trip - 3.mp4, your format should read ${FILENAME} - ${SEG_NUM}${EXT}

Export project formats

LosslessCut also allows importing/exporting your project (segments) in a variety of file formats.

CSV

  • The CSV export/import function takes CSV files with one cut segment on each line. Each line contains three columns: segment start, segment end, label.
  • segment start and segment end are expressed in seconds or left empty. Empty segment end means segment ends at the duration of the video.
  • Use comma , to separate the fields (not semicolon ;)

example.csv

,56.9568,First segment starting at 0
70,842.33,"Another quoted label"
1234,,Last segment

TSV

Same as CSV but <tab> instead.

More formats?

See #1340