Playback: voyant_playback_check

Validate a recording and print frame metadata.

Validates recorded .vynt data integrity and prints frame-by-frame metadata — useful for checking a recording without opening the full visualizer.

Use voyant_playback_check --help to see all available options.

Data Sources

Use a Voyant .vynt data file from either:

• Your own recordings — captured with voyant_logger_binary or the visualizer.
• Sample datasets — downloaded from our releases:
  • car_parking-v1_0_0.vynt
  • people_walking-v1_0_0.vynt

Usage

Basic Playback

voyant_playback_check --input my_recording.vynt

Custom Playback Speed

voyant_playback_check --input my_recording.vynt --rate 3.0

Continuous Looping

voyant_playback_check --input my_recording.vynt --loopback

Expected Output

When playing back a valid recording:

Found valid Voyant data log file: DataLogPrefix { ... }
Frame 4418: timestamp 1743622138.467240245
Points Count: 15093
-----------------------------------
...

Shows the log file header, then per-frame metadata: frame index, timestamp, and point count.

Options

• --input <FILE> - Path to the .vynt recording file
• --rate <MULTIPLIER> - Playback speed (1.0 = real-time, 2.0 = double speed, 0 = as fast as possible) (default: 1.0)
• --loopback - Repeat playback when reaching end of file
• --keep-invalid-points - Keep invalid points in the point counts, if the recording has them (see diagnostic mode — an ordinary recording has none)

Troubleshooting

If playback fails:

• Verify the file is a valid Voyant .vynt recording — a recording made before v1.0.0 must first be converted with voyant_recording_migrate (the error message names the exact command)
• Check file permissions and path
• Ensure the file wasn’t corrupted during transfer