Troubleshooting

Diagnosing decode problems in the browser.

A dropped file does not decode

  • The browser cannot decode the video. The decoder needs WebCodecs with H.264, which Chrome and other Chromium browsers, Safari 16.4 and later, and Firefox 130 and later provide on a secure page. Open the decoder over HTTPS in one of them.
  • The file is not MP4 or MOV. Convert other containers first. See Clips.
  • The file has no DataBorder. See the next section.

"no DataBorder data recovered"

The decoder read the file but found no DataBorder in it. Check the following:

  • The DataBorder was off. Open DataBorder on the camera. It must be enabled and the tags must have records.
  • The recording is not the 1080p stream. The camera draws the DataBorder only on its native 1920 × 1080 stream. A recording of a lower-resolution profile has the overlay but no DataBorder. A copy of the 1080p stream scaled down to 480p or more still decodes.
  • The ring is cropped. The whole ring must be in the frame. A clip that was cropped, or a screen recording of a window that cut off the edge, has lost the data.
  • The clip was compressed too hard. Open the clip in the signal view to see the margin and the corrections.

Some frames are marked unrecoverable

Some frames decoded and others did not. This usually means that the stream profile or the recorder is compressing too hard, or that something is drawn over part of the ring. The findings in the signal view say which. See Recording for bitrate guidance.

Tampered or gap on a genuine clip

A gap at the start or the end of a clip is normal. That is where the clip was cut. A tampered mark in the middle of a clip you exported yourself usually means that the export re-encoded the video and dropped or duplicated frames along the way. Export with stream copy instead.

Values decode but the lanes have no names

The clip is too short to have seen the record dictionary in the carousel, and the library lists it under a camera named "unknown". The names arrive within a few seconds of stream, so cut a longer clip.

Signatures show as unverified

The decoder verifies signatures with the browser's WebCrypto, and the browser lacks Ed25519. The chain still verifies, so the trust band shows chained rather than signed. Open the clip in a current Chrome, Safari or Firefox.

Full history is empty

The camera sends its stored history only when Full history in stream is on under DataBorder. A clip must be long enough to carry at least one complete chunk. A longer clip fills in more.

Everything is gone after a reload

The decoder keeps its data in the tab only. Reloading or closing the tab discards every clip. Drop the clips again.