> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decktalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Verify
> Look up how decktalk verify measures section starts, cuts, cut continuity, and cues, and what each result means.
`decktalk verify` is the one read-only checker after a build. It repeats what each recording log
judged, and then checks the final mp4 in three ways: section starts, cuts, and cues. A section that
sets `seamless` adds a fourth check, cut continuity. This page defines each measurement, limit, and
result, in the order that `verify` computes them, and lists
[every verdict](#every-verdict) with its cause and its fix.
```text theme={null}
check cue at chg % ctl % offset a/v result
1:1.1title 0.50 0.50 1.87 0.00 -20ms -24ms changed
2:2.1code 9.43 23.71 10.79 0.00 +10ms -1ms changed
3:3.1make 8.71 38.87 10.85 0.00 +10ms -6ms changed
```
Every field named on this page is a key under `[verify]` in [Configuration](/reference/configuration#verify),
unless the page names another table. The defaults assume 25 fps, so one frame lasts 40 ms.
## Which checks run
The verify stage inside `decktalk build` runs the same five checks as the command: the recordings,
the section starts, the cuts, cut continuity and every cue. It names no cue, so it checks every cue
in `cue-times.json` that `cues.json` does not opt out.
* With no cue named, `verify` checks every cue in `cue-times.json`, in section order and then cue time.
* With no cue named, `verify` skips a cue that `cues.json` marks `"verify": false`.
* Named cues run in the order given.
* A named cue runs even when `cues.json` marks it `"verify": false`.
* `--only N` keeps only the cues of section `N`, named cues included. A named cue outside `--only` gets no row.
* Section starts, cuts, and cut continuity are always checked, whatever `--only` names. `--only` does keep the recordings table to the sections it names.
A named cue has the form `SECTION:CUE`, such as `2:2.1formula`. `SECTION` is the section number and
not the scene number, and a section can play a scene with another number. A name that does not start
with a section number is an error (`malformed check`), and the command exits 1.
## Recordings
Each page section's recording log holds the verdicts `record` reached when it made the recording, and
`verify` reports them again, so a page that threw or an equation that was never typeset is still a
finding long after the build.
```text theme={null}
sec recording
01 ok
02 ok
03 ok
```
A row carries every verdict its recording log holds, and `ok` when it holds none. A section with no
recording log gets no row, and a clip section never has one. `verify` measures none of this. It
reads the log that `record` wrote and repeats the judgement, which is why a rebuild of one section
is the only thing that clears such a row.
## Section starts
The start check confirms that each section opens on a visible frame.
```text theme={null}
sec start probe YAVG YMAX result
01 0.00 0.20 235 242 ok
02 14.28 14.48 235 242 ok
03 30.16 30.36 235 240 ok
total 44.88s, 0 black section start(s)
```
A section's start is the total length of the `build/sections/NN.mp4` of every earlier section in `decktalk.toml`.
The check reads one frame after each start.
`verify` reads only the sections in `decktalk.toml`. A file that matches `sections/NN.mp4` but belongs to no section,
such as one left after you renumber sections, is ignored, and `verify` warns about it.
```text theme={null}
probe = section start + after_dip_seconds # 0.2 s
BLACK when YMAX of the probe frame <= visible_ymax # 60
```
* `YMAX` is the brightest luma in the frame, and `YAVG` is the average. A mid-gray slide with no pixel above 60
reads `BLACK`.
* The probe sits 0.2 s after the start, whatever the dip length. The default `[transition] dip_seconds` of
0.15 s rounds to 4 frames, 0.16 s. If you set a longer dip, raise `after_dip_seconds` too.
* A clip section has a row too. The starter has no clip section, so every row of the sample above is a page section.
## Cuts
The cut check confirms that the narration is quiet just before each cut.
```text theme={null}
sec cut at before cut result
01 14.29 -120.0 dB quiet
02 30.17 -120.0 dB quiet
03 43.35 -120.0 dB quiet
```
`cut at` is where the section's narration ends in the final mp4. The check measures the narration track in the
window before it.
```text theme={null}
cut at = section start + its span on the narration clock
window = min(cut_window_seconds, section duration) # 0.15 s
SPEECH AT CUT when RMS of narration.mp3 over the window > cut_max_db # -40 dBFS
```
* The check reads `narration.mp3` alone. Music or a sound effect at a cut does not count.
* A level of exactly -40 dBFS passes.
* A clip section has no row, because it has no narration.
* A page section's `hold_seconds` comes after its `cut at`. In the sample, the starter's section `03`
sets `hold_seconds = 1.5`, so it holds its last slide from 43.35 s to the end of the video.
## Cut continuity
The continuity check confirms that the cut into a section that sets `seamless = true` in
`decktalk.toml` does not show. It runs only for those sections.
```text theme={null}
sec cut at chg % result
02 14.28 27.60 POP AT CUT
03 30.16 23.59 POP AT CUT
```
The starter's three scenes each open on a picture of their own, so setting `seamless` on sections 2
and 3 is a claim the pages do not keep, and the check says so. A section whose page really does open
on the previous section's last picture reads `ok` with a changed share near zero.
`cut at` is the section start in the final mp4. `chg %` is the [changed share](#changed-share) of two
frames at `diff_level`: the previous section's last frame before any dip, and this section's first
frame after any dip.
```text theme={null}
last frame = the frame 1 frame before (cut at - the dip, when the previous section fades out)
first frame = the frame at (cut at + the dip, when this section fades in)
POP AT CUT when changed share(last frame, first frame) > max_pop_percent # 0.1
```
* The frames sit outside the dip, so a fade through black is never a pop. A dip still shows on screen, so leave
the pair out of `[transition] dips` for a cut that should not show.
* The default of 0.1 matches `min_changed_percent`, so any change that would pass as a reveal is a pop.
* A section with no `sections/NN.mp4`, or whose previous section has none, gets no row.
* `POP AT CUT` is a certain finding, so `decktalk verify` and `decktalk build` exit 1 on it.
## Cues
The cue check confirms that the picture changes on each cue, at the cue time.
```text theme={null}
check cue at chg % ctl % offset a/v result
2:2.1code 9.43 23.71 10.79 0.00 +10ms -1ms changed
```
A voiced build prints the same columns and leaves `a/v` out, because its audio carries speech rather
than clicks.
Each column maps to one term. The terms below come in the order that `verify` computes them.
| Column | JSON field | Term | Unit |
| -------- | ------------------- | ----------------------------------------------------- | ------------------------------- |
| `check` | `section`, `cue` | the named cue | none |
| `cue` | `cue_seconds` | [Cue time](#cue-time) | seconds after the section start |
| `at` | `final_seconds` | the cue time in the final mp4 | seconds |
| `chg %` | `changed_percent` | [Changed share](#changed-share) of the reported probe | percent |
| `ctl %` | `control_percent` | [Control share](#control-share) of the reported probe | percent |
| `offset` | `offset_ms` | [Offset column](#onset-and-offset) | milliseconds |
| `a/v` | `av_ms` | [The a/v value](#the-a/v-value) | milliseconds |
| `result` | `verdict`, `reason` | [Results](#results) | none |
Note: The table prints the `a/v` column only when at least one row has an a/v value. The JSON `silent` key
says whether the build was silent.
### Cue time
The cue time is the start of the cued word plus the offset key. It is rounded to hundredths, in seconds after
the section start.
```text theme={null}
cue time = round(word start + offset key, 2)
at = section start in the final mp4 + cue time
```
* `$start` has a word start of 0.0 s. `$end` has the end of the section's last spoken word.
* Each row of `build/cue-times.json` keeps its word start in `word_at`, without the offset key, also rounded to hundredths.
* A `$start` cue with a negative offset key keeps its negative cue time.
Example: section 2 starts at 14.28 s, and `2:2.1code` has a cue time of 9.43 s. Its `at` is 23.71 s.
### Changed share
The changed share of two frames is the percentage of pixels whose luma differs by more than a level.
`verify` scales both frames to `probe_width` by `probe_height` first, which is 480 by 270.
```text theme={null}
changed share(a, b, level) = 100 * (pixels where |luma of a - luma of b| > level) / (probe_width * probe_height)
```
* Every share is on a 0 to 100 scale. At 480 by 270, a share of 0.1 is about 130 pixels.
* The share compares luma only. A reveal that changes only color at the same brightness reads `NO CHANGE`.
Mark such a cue `"verify": false` in `cues.json`.
* Probes and control shares use `diff_level` (40). The onset scan uses `onset_diff_level` (12). It also reads a
block share at `block_width` by `block_height` (240 by 135). [Onset and offset](#onset-and-offset) says why.
* A pixel counts only when its difference is strictly greater than the level.
Example: the `chg %` of 10.79 for `2:2.1code` is about 13,990 of 129,600 pixels.
### Reference frame
The reference frame is the picture before the cue. Every probe is compared with it.
```text theme={null}
lead = max(lead_seconds, (max_offset_frames + 1.5) / fps) # max(0.1, 0.14) = 0.14 s
floor = section start, plus the dip when the cut fades the section in
reference = the first frame at or after max(floor, at - lead)
skipped REFERENCE_CLAMPED when max(floor, at - lead) > at - 1 / fps
```
* `[verify] reference_lead_seconds` has an effect only above (`max_offset_frames` + 1.5) / `fps`, which is 0.14 s at the
defaults.
* `[verify] reference_lead_seconds` is not the recording log's `clock_start_seconds`. The recording log value is the recorder's wall-clock
wait before narration t=0.
* The lead keeps every frame inside the offset limit after the reference, so an early reveal is not already in
it. A reveal earlier than the reference frame usually reads `NO CHANGE`.
* With `[transition] page_fades_in = true`, the default, the cut adds no fade-in to a page section. The floor of
a page section is then its first frame.
* A clip section gets the dip when a dip comes before it. So does a page section when `page_fades_in` is false.
* A row is `REFERENCE_CLAMPED` when its cue time is under 0.04 s with no fade-in, or under 0.20 s with the
default fade-in. A named cue is still skipped.
* The reference time is at least one frame before the cue. The reference frame can be closer when the cue time
is off the frame grid.
Example: for `2:2.1code`, the reference time is 23.71 - 0.14 = 23.57 s. The reference frame is the
next frame on the 40 ms grid, at 23.60 s. That frame is 110 ms before the cue.
### Probes
A probe is the frame a fixed delay after the cue. `verify` takes one probe for each delay in `probe_delays`.
```text theme={null}
probe(d) = at + d for each d in probe_delays # 0.7 s and 1.5 s
dropped when probe(d) > section end - 0.05
```
* The section end is the next section's start in the final mp4, or the video length for the last section.
* The later probe catches a slow reveal.
* The row is `TOO_CLOSE_TO_END` only when every probe is dropped. At the defaults, that is a cue less than
0.75 s before the section end.
### Control share
The control share measures motion that has nothing to do with the cue. Each probe gets its own control share.
```text theme={null}
span = probe(d) - reference time
control = min(changed share(reference - 2 * span, reference - span),
changed share(reference - span, reference)) # at diff_level
```
* Each span compares only its first and its last frame.
* A span that starts before the floor is dropped. If both spans are dropped, the control share is 0.
* Steady motion, such as a camera push, shows in both spans. An earlier reveal that is still finishing shows in
only one, so the smaller share leaves it out.
### Close cues
A cue close to another cue gets probes that fit the gap between them. Otherwise the other cue's reveal would
count as this cue's change, or as motion in every control span.
```text theme={null}
neighbor = another cue of the section, more than the reference lead from this cue # 0.14 s
window = the neighbor's cue time, plus or minus the reference lead
spoiled probe when a window overlaps the span from the reference to the probe,
or a window overlaps every control span that is measured
fitted probe = the longest delay below the probe's delay that is not spoiled,
at least (max_offset_frames + 1) / fps # 0.12 s
```
* A probe that is not spoiled is used as it is. A cue whose probes are all unspoiled is measured exactly as
the sections above describe.
* A fitted probe has shorter control spans, because each span still lasts as long as the probe's span.
* Two probes fitted to the same delay count once. The probes are then taken in order of delay.
* If no probe can be fitted, `verify` uses `probe_delays` as they are.
* A cue within the reference lead of another is part of the same reveal, so it is not a neighbor.
* Every cue of the section in `cue-times.json` can be a neighbor, including a cue that the run does not check.
* `verify` logs `another cue is close, so the probes are fitted to s after the cue` for each such cue.
Example: a count reveals a box on each of four cues, at 4.42, 5.11, 5.62, and 6.18 s. The last cue's reference
time is 6.04 s. Its 0.7 s probe has control spans from 5.20 to 6.04 s and from 4.36 to 5.20 s. The 5.62 s window
overlaps the first span, and the 4.42 s window overlaps the second, so the probe is spoiled. The probe is
fitted to 0.14 s. Its first control span, from 5.76 to 6.04 s, clears the 5.62 s window, which ends at 5.76 s.
### Change test
The change test decides whether the picture changed because of the cue.
```text theme={null}
margin(d) = changed share(d) - control share(d)
reported probe = the probe with the largest margin, the earlier probe on a tie
passes when changed share >= min_changed_percent and margin >= min_margin_percent # 0.1 and 0.1
thin when changed share < thin_change_factor * min_changed_percent # 3 * 0.1
or margin < thin_change_factor * min_margin_percent # 3 * 0.1
```
* If the reported probe fails the change test, the row is `NO CHANGE`.
* A row that passes by a thin change reads `THIN CHANGE?` instead of `changed`. The change is thin when the
changed share is below `thin_change_factor` times `min_changed_percent`, or the margin is below
`thin_change_factor` times `min_margin_percent`. At the default factor of 3, both limits are 0.3.
* `THIN CHANGE?` is an uncertain finding. The cue passed, but a slightly smaller reveal or a little more motion
would fail it. `verify` exits 1 on it only with `--strict`. Set `thin_change_factor` to 1 to turn it off.
* The `chg %` and `ctl %` columns show the reported probe, which is not always the probe that changed most.
* `min_changed_percent` applies to the raw changed share. A camera push raises that share too.
Example: `2:2.1code` has a changed share of 10.79 and a control share of 0.00. Its margin is 10.79, so
it passes, and the change is not thin. The next cue, `2.1waited`, fires 1.88 s later, so both probes
clear it and `verify` reports the probe with the larger margin.
### Onset and offset
After a cue passes the change test, `verify` finds its onset, the first frame of the reveal.
1. `verify` measures the changed share of each frame from the reference frame up to the reported probe. It
compares each frame with the reference frame, at `onset_diff_level`. It also measures a block share of each
frame, the same comparison with both frames scaled to `block_width` by `block_height` (240 by 135).
2. The onset is the first frame after the reference whose share rises by at least `onset_percent` over the
frame before it, and whose block share is above 0.
3. If no frame rises that much, the onset is the first frame after the reference whose share is above a
threshold, and whose block share is above 0.
4. If no frame is above the threshold, the row has no onset.
The figure carries the numbers of the cue it draws. Its shares use `onset_diff_level` (12), which is
why its onset frame reads a larger share than the `chg %` column of the same cue: the change test
uses `diff_level` (40), at the probe 0.7 s after the cue.
```text theme={null}
series[0] = 0 # the reference frame itself
series[i] = changed share(reference frame, frame i, onset_diff_level)
blocks[i] = the same share, with both frames scaled to block_width by block_height
onset = first i >= 1 with series[i] - series[i-1] >= onset_percent and blocks[i] > 0 # 0.01
threshold = max(onset_percent, largest series[i] at or before at - (max_offset_frames + 0.5) / fps)
fallback onset = first i >= 1 with series[i] > threshold and blocks[i] > 0
offset column = round(1000 * (onset time - at)) # whole ms, negative means early
```
* A rise is in percentage points of share. At 480 by 270, 0.01 points is about 13 pixels.
* At 240 by 135, each pixel averages an 8 by 8 block of a 1080p frame, the size of an H.264 transform block.
The x264 encoder leaves a little ringing on a still picture in the one or two frames before a change: a few
pixels, up to about 15 luma levels apart at 480 by 270. Alone, that ringing read as a reveal 40 to 100 ms
before it happened, while the recording showed the reveal on time. Ringing is as much lighter as darker, so
it cancels over a block and leaves the block share at 0. A reveal changes whole blocks, so its first frame
has a block share above 0.
* A reveal changes the picture in one jump. Steady motion, such as a camera push or a line that was already drawing
before the reference, grows a little every frame. That motion does not count as an onset, but it can change
frames before the onset.
* The onset threshold is far below `min_changed_percent` on purpose. A fade starts on its cue but takes many
frames to change 0.1 percent of the pixels.
* The fallback catches a reveal that grows slowly, such as text that types in. At the defaults, its window ends
100 ms before the cue.
* The onset can come before the cue time.
* A cue with no onset reads `changed`. Its offset column shows `-`, its `a/v` is blank, and neither limit
applies. No `NO_CLICK` reason is set.
Example: `2:2.1code` has an offset column of +10 ms, so its onset frame is at 23.72 s.
### The a/v value
After a build without voice, `verify` also compares the picture with the sound in the final mp4. The click track of a
build without voice has a click at every word start, and one where the section's last word ends.
```text theme={null}
click = the loudest sample within click_search_seconds of the word start, inside the cue's section
click found when |sample| >= 400 of 32768 # about -38 dBFS
click distance = round(1000 * (click time - word start))
a/v = offset column - click distance
= (onset - click) - offset key # milliseconds
```
* The word start comes from the row's `word_at`, so the offset key does not add to `a/v`. An `a/v` of 0 means
the picture changes one offset key after the click.
* The offset column compares the picture with the cue time in `cue-times.json`. The `a/v` value compares the
picture with the audio in the final file.
* An `a/v` near 0 shows that these steps kept sound and picture together: the recording, the trim at narration
t=0, the cut, the join, and the mix.
* The search window never reaches past the cue's own section, so the audio of a clip next to it is never the
click.
* A sound effect or music that is louder than the click inside the window becomes the click. A
`decktalk build --no-voice --no-soundscape` leaves them out of the mix.
* The clicks stay at -24 dBFS, because a build without voice skips the [loudness pass](/concepts/sound#loudness).
* If no sample reaches the level, the row gets the reason `NO_CLICK`, and its `a/v` is blank. The row keeps its
offset result.
* `NO_CLICK` is usual for a `$end` cue whose last word is longer than `click_search_seconds`. `$end` anchors on
the end of the last word, and clicks sit on word starts. A shorter last word gives an `a/v` that is off by the
word's length.
* A voiced build has no `a/v`. Its JSON `silent` is `false`, and every `av_ms` is `null`.
Example: `2:2.1code` has an offset column of +10 ms and an `a/v` of -1 ms, so its click distance is
+11 ms.
### Limits
Two limits turn a measured row into `OFF CUE`. Both apply to early and late values.
```text theme={null}
offset limit = 1000 * max_offset_frames / fps # 80 ms
a/v limit = 1000 * max_av_frames / fps # 120 ms
OFF CUE when |offset column| > offset limit + 0.5, or |a/v| > a/v limit + 0.5
```
* The a/v limit is one frame wider, because the click carries encoding jitter too.
* The table prints only the result. Compare the offset column with the offset limit and `a/v` with the a/v
limit to see which one failed.
* A slower machine can put a reveal two or three frames late. [Build in CI and offline](/guides/ci-and-offline)
shows how to widen the limits on one runner.
This example shows the format of an `OFF CUE` row.
```text theme={null}
check cue at chg % ctl % offset a/v result
2:2.1formula 5.81 20.09 1.86 0.00 -90ms -101ms OFF CUE
```
This row is `OFF CUE` because its offset column, -90 ms, is past the 80 ms offset limit. Its `a/v` of
-101 ms is inside the 120 ms a/v limit. The offset key moved the cue time 0.14 s later than the
reveal the page already recorded, which is what a cue phrase on the wrong word looks like.
## Results
Each cue row gets its result from the first rule that matches.
1. If the run names no cue and `cues.json` marks the cue `"verify": false`, the row is `skipped` with the reason
`OPTED_OUT`.
2. If a named cue is not in `cue-times.json`, the row is `UNRESOLVED`.
3. If the section has no `sections/NN.mp4`, the row is `skipped` with the reason `SECTION_NOT_ASSEMBLED`.
4. If no reference frame fits, the row is `skipped` with the reason `REFERENCE_CLAMPED`.
5. If every probe is dropped, the row is `skipped` with the reason `TOO_CLOSE_TO_END`. A cue close to another
cue gets [fitted probes](#close-cues) first.
6. If the reported probe fails the change test, the row is `NO CHANGE`.
7. If the scan finds no onset, the row is `changed`, with `-` in the offset column and no `a/v`. A thin change
reads `THIN CHANGE?` instead.
8. If the offset column is past the offset limit, the row is `OFF CUE`.
9. After a build without voice, if no click is found, the row gets the reason `NO_CLICK` and keeps the result of rule 8.
10. After a build without voice, if the `a/v` is past the a/v limit, the row is `OFF CUE`.
11. Otherwise, the row is `changed`, or `THIN CHANGE?` when the change is thin.
## Every verdict
This is every verdict `decktalk verify` can print, with what makes it and what to do about it. A
certain verdict exits 1 on its own. An uncertain verdict ends in a question mark and exits 1 only
with `--strict`. A passing verdict is never a finding. Match a verdict by its code, which is the
`code` field of the JSON object, and never by its label.
| Verdict | Code | Kind | Table | Cause | Fix |
| ------------------ | ------------------ | --------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PAGE ERROR` | `PAGE_ERROR` | certain | recordings | The page threw an uncaught error while it recorded, or it never exposed the runtime catalog. | Open the page in a browser and fix the error. [Warnings](/reference/runtime#warnings) lists what the runtime reports on its own. |
| `STALLED` | `STALLED` | certain | recordings | Page frames froze for longer than `[record] stall_ms` after narration t=0. | Make the slide cheaper to draw, or do the slow work before t=0, where the cover hides it. |
| `TRUNCATED` | `TRUNCATED` | certain | recordings | The recording is shorter than the length `record` asked for, by more than `[record] truncated_slack_seconds`. | Record the section again. A repeat usually means the machine could not keep up. |
| `NO COVER` | `NO_COVER` | certain | recordings | `record` found no magenta cover, so narration t=0 is an estimate and every reveal in the section moves with it. | Record the section again. A page that paints late can raise `[record] cover_scan_seconds`. |
| `KATEX ERROR` | `KATEX_ERROR` | certain | recordings | KaTeX refused a `data-tex` value, so the slide shows red source. | Fix the TeX. Inside a `render` template literal, write every backslash twice. |
| `KATEX NOT LOADED` | `KATEX_NOT_LOADED` | certain | recordings | The page asked for KaTeX and it never arrived, so the source stayed plain. | Load KaTeX before the runtime, from the `deck/katex/` directory `decktalk init` wrote. |
| `BLACK?` | `BLACK_UNSURE` | uncertain | recordings | The brightest luma of the recording's middle frame is below `[record] black_ymax`. | Look at the section. A dark slide on purpose needs no change. |
| `BLACK` | `BLACK` | certain | starts | The brightest luma of the frame `after_dip_seconds` into the section is at most `[verify] visible_ymax`. | Give the section's first slide something visible at its start, or raise `after_dip_seconds` past a longer dip. |
| `SPEECH AT CUT` | `SPEECH_AT_CUT` | certain | cuts | The narration is louder than `[verify] cut_max_db` in the `cut_window_seconds` before the cut. | Raise the section's `tail_seconds`, or end the section on a shorter last word. |
| `POP AT CUT` | `POP_AT_CUT` | certain | seams | A section sets `seamless = true`, and the two frames across its cut differ by more than `[verify] max_pop_percent`. | Make the page open on the previous section's last picture, or drop `seamless`. |
| `OFF CUE` | `OFF_CUE` | certain | cues | The offset column is past the offset limit, or the `a/v` value is past the a/v limit. | Check the cue phrase against the spoken words. A whole run that is late is a slow machine, and [Build in CI and offline](/guides/ci-and-offline) widens the limits. |
| `NO CHANGE` | `NO_CHANGE` | certain | cues | The reported probe failed the change test, so nothing measurable happened at the cue. | Make the reveal larger, or mark the cue `"verify": false` and check it by eye. A reveal that changes only color at the same brightness always reads this way. |
| `THIN CHANGE?` | `THIN_CHANGE` | uncertain | cues | The cue passed the change test by less than `thin_change_factor` times a floor. | Make the reveal larger, or set `thin_change_factor` to 1 to turn the warning off. |
| `UNRESOLVED` | `UNRESOLVED` | certain | cues | A named cue is not in `build/cue-times.json`. | Run `decktalk align`, or fix the cue phrase that never matched. |
| `changed` | `CHANGED` | passing | cues | The picture changed on the cue, inside both limits. | Nothing to do. |
| `quiet` | `QUIET` | passing | cuts | The narration is quiet before the cut. | Nothing to do. |
| `ok` | `OK` | passing | recordings, starts, seams | The row was measured and nothing is wrong. | Nothing to do. |
| `skipped` | `SKIPPED` | passing | cues | The row measured nothing, and its `reason` says why. | [Skipped rows](#skipped-rows) gives each reason. |
`decktalk verify` exits 1 on any certain verdict above, and on an uncertain one with `--strict`. A
`skipped` row never fails. [Exit codes](/reference/cli#exit-codes) lists the codes for every command.
## Skipped rows
A skipped row measured nothing. The table prints `skipped`, the reason, and a short note.
| Reason | Cause | Fix |
| ----------------------- | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `OPTED_OUT` | `cues.json` marks the cue `"verify": false`, and the run named no cue. | Name the cue, such as `decktalk verify 2:2.1formula`, to measure it anyway. |
| `SECTION_NOT_ASSEMBLED` | The section has no `build/sections/NN.mp4`. | Run `decktalk assemble`. |
| `REFERENCE_CLAMPED` | No reference frame fits between the floor and one frame before the cue. Usual for a `$start` cue. | Check the reveal by eye with `decktalk screenshots --slide ID --after CUE`. |
| `TOO_CLOSE_TO_END` | Every probe falls later than 0.05 s before the section end. | Check the reveal by eye with `decktalk screenshots --slide ID --after CUE`. |
Note: `NO_CLICK` is a reason on a measured row, not a skipped row. [The a/v value](#the-a/v-value) explains it.
A reveal that is too small or too slow for a frame difference, such as a thin arrow, can fail the change test.
Mark such a cue `"verify": false`, and check it by eye with `decktalk screenshots --slide ID --after CUE`.
## JSON fields
`decktalk verify --json` prints one JSON object on stdout. The measurements are under the `verify` key.
```json theme={null}
"cues": [
{
"section": 2,
"cue": "2.1formula",
"where": "build/out/my-lesson.mp4",
"cue_seconds": 5.81,
"final_seconds": 20.09,
"changed_percent": 1.86,
"control_percent": 0.0,
"offset_ms": -90,
"av_ms": -101,
"verdict": {
"code": "OFF_CUE",
"label": "OFF CUE",
"certain": true
},
"reason": null,
"detail": "the reveal at cue '2.1formula' first changed -90 ms from its cue, outside the 80 ms limit."
}
]
```
| Field | Type | Meaning |
| ---------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `command` | string | Always `"verify"`. |
| `version` | string | The installed DeckTalk version. |
| `ok` | boolean | True when the command found nothing and raised nothing. It ignores `--exit-zero`. |
| `findings.certain`, `findings.uncertain` | integer | Counts of certain and uncertain findings. |
| `verify.final` | string | Path of the final mp4, relative to the project. |
| `verify.total_seconds` | number | Length of the video, the sum of the `sections/NN.mp4` of every section in `decktalk.toml`. |
| `verify.silent` | boolean | True after a build without voice. Only then can `av_ms` hold a value. |
| `verify.recordings[]` | array | One object per recorded page section, with `key`, `where`, which is its recording log, `t0_method`, `verdicts`, which is a list of verdict objects, and `page_errors`. |
| `verify.starts[]` | array | One object per section start, with `key`, `start`, `probe_at`, `yavg`, `ymax`, and `verdict`. |
| `verify.cuts[]` | array | One object per cut, with `key`, `cut_at`, `rms_db`, and `verdict`. |
| `verify.seams[]` | array | One object per section that sets `seamless`, with `key`, `cut_at`, `last_at`, `first_at`, `changed_percent`, and `verdict`, whose code is `OK` or `POP_AT_CUT`. |
| `verify.cues[]` | array | One object per cue row, with the fields of the next table. |
| Cue field | Type | Meaning |
| ----------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `section` | integer | Section number. |
| `cue` | string | Cue id. |
| `where` | string | The finished film the row was measured in, relative to the project. |
| `cue_seconds` | number or null | Cue time, in seconds after the section start. |
| `final_seconds` | number or null | Cue time in the final mp4. |
| `changed_percent` | number or null | Changed share of the reported probe. |
| `control_percent` | number or null | Control share of the reported probe. |
| `offset_ms` | integer or null | Offset column. Null when the row has no onset. |
| `av_ms` | integer or null | `a/v` value. Null after a voiced build, with no onset, or with `NO_CLICK`. |
| `verdict` | object | `{code, label, certain}`. The code is `CHANGED`, `THIN_CHANGE`, `OFF_CUE`, `NO_CHANGE`, `UNRESOLVED` or `SKIPPED`. Match on the code and never on the label. |
| `reason` | string or null | The skip reason, or `NO_CLICK` on a measured row. |
| `detail` | string or null | One sentence that says what the row found, with the measured number in it. Null on a row that passed. |
Note: Seconds are rounded to three decimals, and shares to two. A skipped row has null measurements. Every row of `starts[]`, `cuts[]` and `seams[]` carries `where` and `detail` too.
## Related
* **Run the command and read its options:** [CLI](/reference/cli#decktalk-verify)
* **Fix a failed check:** [Troubleshooting](/help/troubleshooting)
* **Change a limit:** [Configuration](/reference/configuration#verify)