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 https://github.com/mifi/lossless-cut/issues/1340