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

Improve documentation for export variables.

Browse Source 
Adds descriptions for export variables.
This commit is contained in:
Sacha Sayan 2022-11-07 17:02:28 -05:00 committed by Mikael Finstad
parent 7b4c285738
commit 02a1d1f1f5
1 changed files with 31 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
import-export.md
View File

@ -1,20 +1,46 @@
# Import / export
# Import / Export
LosslessCut allows importing/exporting your project (segments) in a variety of file formats.
## CSV
## 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
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
#### example.csv
```csv
,56.9568,First segment starting at 0
70,842.33,"Another quoted label"
1234,,Last segment
```
## More formats?
### More formats?
See https://github.com/mifi/lossless-cut/issues/1340