voyant_playback_check
Validate recorded data integrity and display frame metadata. Useful for verifying recordings without full visualization.
Use voyant_playback_check --help to see all available options.
Usage
Basic Playback
voyant_playback_check --input my_recording.bin
Custom Playback Speed
voyant_playback_check --input my_recording.bin --rate 3.0
Continuous Looping
voyant_playback_check --input my_recording.bin --loopback
You can download sample datasets from the Playback Tools section.
Expected Output
When playing back a valid recording:
Found valid Voyant data log file: DataLogPrefix { magic: [86, 89, 78, 84], file_header_size: 28 }
Log created at: 1743622138.467240245
Logged using API version: 0.1.0
Starting playback at 1.00x speed (filtering invalid points)...
(Press Ctrl+C to stop)
Frame header: VoyantHeaderWrapper { ... frame_index: 4418, device_class: Ldk, ... }
Points Count: 15093
-----------------------------------
...
Shows log file info, creation timestamp, API version, and frame-by-frame metadata including frame index and point counts.
Options
--input <FILE>- Path to the binary recording file--rate <MULTIPLIER>- Playback speed (1.0 = real-time, 2.0 = double speed) (default: 1.0)--loopback- Repeat playback when reaching end of file--keep-invalid-points- Include invalid points in point counts
Troubleshooting
If playback fails:
- Verify the file is a valid Voyant
.binrecording - Check file permissions and path
- Ensure the file wasn’t corrupted during transfer