1
0
mirror of https://github.com/mifi/lossless-cut.git synced 2024-11-25 11:43:17 +01:00

Update import-export.md

This commit is contained in:
Mikael Finstad 2022-11-08 19:52:59 +07:00
parent 02a1d1f1f5
commit d7af45e8fe

View File

@ -1,30 +1,6 @@
# Import / Export
## Exporting multiple files
When exporting multiple segments as separate files, LosslessCut offers you the ability to specify how the output files will be named in sequence. The following (variables) are available to customize the filenames:
| Variable | Output |
| ------------- |--------|
| ${FILENAME} | The original filename without the extension (eg **Beach Trip** for a file named "Beach Trip.mp4")
| ${EXT} | The extension of the file (eg: **.mp4**, **.mkv**)
| ${SEG\_NUM} | Number of the segment (eg **1**, **2**, **3**)
| ${SEG\_LABEL} | The given label of the file (eg **Getting\_Lunch**)
| ${SEG\_SUFFIX} | If a label exists for this segment, the label will be used. Otherwise, the segment number will be used (eg **Getting\_Lunch**, **1**)
| ${CUT\_FROM} | cutFrom - The timestamp for the beginning of the segment in hh.mm.ss.sss format (eg **00.00.27.184**)
| ${CUT\_TO} | cutTo - The timestamp for the ending of the segment in hh.mm.ss.sss format (eg **00.00.27.184**)
| ${SEG\_TAGS.**XX**} | Allows you to retrieve the json tags for a given segment by name. If a tag is called foo, it can be accessed with $**{SEG\_TAGS.foo}**
Typically, your files should always have a unique identifer (such as SET\_NUM or CUT\_FROM), and they must always end in ${EXT}. For instance, to achieve a filename sequence of **Beach Trip - 1.mp4, Beach Trip - 2.mp4, Beach Trip - 3.mp4**, etc, your format should read:
```
${FILENAME} - ${SEG_NUM}${EXT}
```
## Export formats
## Export project formats
LosslessCut also allows importing/exporting your project (segments) in a variety of file formats.
@ -44,3 +20,20 @@ LosslessCut also allows importing/exporting your project (segments) in a variety
### More formats?
See https://github.com/mifi/lossless-cut/issues/1340
## 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. The following variables are available to customize the filenames:
| 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`)
| `${SEG_NUM}` | Number of the segment (e.g. `1`, `2` or `3`)
| `${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}`
Your files must always include at least one unique identifer (such as `${SEG_NUM}` or `${CUT_FROM}`), and they 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}`