import_take
Add existing video recordings to a session as takes without editing session.json. Automatically names, numbers, reads length, and lists them; supports single or multiple takes.
Instructions
Add recordings that already exist (e.g. from QuickTime, a phone, a download, or files placed in the session folder) to a session as takes. Never edit session.json by hand: this names the file take-NN-[name-]camera., gives it the next take number, reads its length and lists it. One take: path (+ screen_path for its screen recording). Several: takes=[{path, screen_path, name, keeper}], one take each, in order. Files outside the session are copied (move=true moves them); files already in the session folder are renamed in place.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| move | No | Move files instead of copying them. Default false. | |
| name | No | Name for the take. | |
| path | No | The camera (or only) video file of one take. | |
| takes | No | Several takes: [{path, screen_path, name, keeper, kind}], one take each, in order. | |
| keeper | No | true stars the take as the keeper. | |
| session | Yes | Session as 'Project/folder', an absolute path, or its id (from get_session). An old path still works after a rename or move. | |
| screen_path | No | Optional: the screen recording of the same take. |