Generate and pick video takes
Make a video take for every shot, check each take, make a failing shot again, and keep the take you want.
A take is one video made for one shot. A shot can have several takes, and one of them is the pick, the take the cut uses. Your agent runs the Videos loop. You look at the takes and say which to keep.
Start after you approve the mock. See Make the mock. A video take made before the mock is approved prints a warning and is recorded. To go ahead anyway, add --reason with your words. Every command here needs a signed-in computer.
Make a take
- Your agent makes the take for one shot from its folder:
minicut gen video episodes/ep01/clips/c01This command uses credits. It shows what it will do and asks before it spends. After your yes it sends the job.
- For many shots at once, your agent uses
minicut gen batch. See Generate. - Your agent saves the finished takes into the project:
minicut jobs --wait 300- Each take is saved in its shot's folder as
t01, thent02, and on. A shot has one job at a time. If the shot already has a job, the command names it. Add--againto make another take beside it. - To see where every shot stands, run:
minicut shots --episode ep01A shot reads queued, running or saving while its job runs. It reads failed if the job failed. It reads unchecked until its take is checked, fail if the take failed, and done when the take is made. See minicut shots.
Check the takes
- Your agent runs:
minicut loop run videos- For each shot, the loop checks the picked take. If the shot has no pick, it checks the newest take. A shot with no video take fails with
no video take yet. - The loop prints one line for each failure, with its fix:
| Failure | What it means |
|---|---|
the take has N s and the shot is N s | The take is more than 0.3 s shorter than its shot, so the cut would hold the last frame still |
the picture stops moving N to N s | The picture is still for 1 s or more |
the light drops from N s and stays down | The take goes dark and stays dark |
the picture changes to another shot at N s | The take holds a cut the shot sheet did not ask for |
the words heard do not match | The speech in the take does not match the shot's lines |
nobody has looked at this take yet | A person or a fresh agent has not yet looked at the take's picture sheet and answered its questions |
- For a cut inside a take, the fix can be
TRIM: keep this take, end the shot at N s. Your agent keeps the take and trims the shot where the line says. - For other failures, the fix is another take:
minicut gen videoon that shot, withtake 2 of 3in the line. Only that shot is made again.
Say what is wrong
When a take fails its look, your agent writes the problem into the shot's prompt, so the next take changes:
minicut fix episodes/ep01/clips/c01 --take t01 --frame 48 --object "the cup" --problem "the cup floats above the table" --instead "the cup rests on the table"The shot then reads as changed, and the Videos loop runs again. To see a take in detail, your agent runs minicut check zoom on it. See Checks and loops.
To check one take without the loop, run minicut check take episodes/ep01/clips/c01. With --take t02 it checks that take.
Stop at the take limit
A shot gets 3 takes by default. At the limit, the failure line reads take cap reached (3 of 3): pick the best take of c01 and tell the user what is still wrong. You decide: pick the best take, or raise the limit. The limit is the takes key in series.json, such as "loops": {"takes": 5}. You can also run minicut loop run videos --max 5.
Pick the take to keep
- Look at the takes for a shot in the MiniCut app:
minicut open rain-shop --episode ep01 --tab shots- When a take passes and the shot has no pick, the loop sets the pick to that take. It does the same when the pick is a mock picture. A pick you made stays.
- To pick a take yourself, run:
minicut asset pick rain-shop ep01 c01 t02- Run
minicut shots --episode ep01again. Every shot showsdone.
Approve the takes
- Look at the picked take of every shot. When the loop passes, it prints
PASSED, show the user:and the command to list the picks. - Say yes. Your agent runs:
minicut loop approve videos- To end the loop with a failure you accept, run
minicut loop done videos --reason "Good enough, ship it".
Check it worked
Run minicut loop. The Videos loop shows as approved or done. The next: line names the next command, followed by a why: line. Continue with Edit an episode.
Errors
| Message | What to do |
|---|---|
Shot <shot> already has job <job> <state>. | Stop the job with minicut jobs --stop <job>, or add --again |
no clip.json in <folder> | Give the path to a shot folder in an episode |
take cap reached | Pick the best take, or raise the limit |
You are not signed in. Ask your agent to run minicut login. | Sign in. See Account |