User Guide
Validrive is a desktop app that helps you review and validate driving events quickly, without having to click through Daredeevil manually.
Instead of opening Excel, copying, searching, replaying, and marking events one by one, Validrive lets you do it all in one simple window.
1. Installation
- Validrive comes as a single file:
Validrive.exe - Place it anywhere on your computer (for example, on your Desktop).
- Double-click to open it.
No setup or installation is needed.
2. Loading your data
- Click Upload File.
- Select your Excel (
.xlsx) or CSV file with event information. - The events will appear in the left panel.
- A preview of your file appears on the right. You can show or hide this preview at any time using the Show preview checkbox.
Required columns
Your file must contain these columns:
- caps → the capsule name (e.g.
CERTIF_BCB_5503_ACC_20230313_095820_400Mid_RSL) - event_type → the type of event (e.g.
lane_change,lane_keep) - start_time → when the event starts (in seconds, e.g.
1.44) - end_time → when the event ends (in seconds, e.g.
4.23)
Example file
| caps | event_type | start_time | end_time |
|---|---|---|---|
| CERTIF_BCB_5503_ACC_20230313_095820_400Mid | lane_change | 12.45 | 17.56 |
| CERTIF_BCB_5503_ACC_20230313_100250_400Mid | lane_keep | 40 | 44.33 |
3. Connecting to Daredeevil
- In Validrive, click Connect Browser.
- A Chrome window will open automatically. Validrive will:
- Launch Daredeevil,
- Detect your file and create a capsule list,
- Choose the right environment (classic Daredeevil or SW500) based on the
capscolumn.
If the capsule name contains “SDV”, it will connect to SW500 Daredeevil. Otherwise, it connects to the standard Daredeevil.
- If you want to stop the connection at any time, click Disconnect Browser.
Note: Before connecting, make sure you are already logged in to Daredeevil in Chrome. Validrive uses your existing login cookies, so you won’t be asked to log in again inside the app.
4. Actions
Once connected, you can perform different actions on each event from your file.
By default, all events start as invalidated until you review them.
Validate
Mark an event as reviewed. This doesn’t mean the event was necessarily “correct” — only that you have checked it and confirmed the information is fine as given.
Examples:
- An event labeled
lane_changereally is a lane change → mark as validated. - An event labeled
brakingwas checked and the label is consistent → mark as validated.
Correct event
Modify the event information if the original data was wrong or incomplete. You can:
- Change the event type.
- Adjust the start/end time.
- Edit a custom column (any additional field in your file).
Examples:
- The file says
lane_keep, but in the video you see alane_change→ correct type. - The event is labeled as starting at
12.0s, but the real action starts at12.8s→ correct start time. - Add a custom note in a
commentcolumn → correct custom column.
Invalidate
Leave the event as not reviewed. This is the default state for all events when first loaded.
It means you haven’t validated or corrected it yet.
Examples:
- A new event appears in your file → it is automatically invalidated until you check it.
- You skip an event because you’re not sure yet → keep it invalidated.
Split
Break one long event into several smaller ones. Each sub-event gets its own ID and can be validated or corrected individually.
Example:
- An event from
10.0sto30.0sactually contains two separate lane changes:- First lane change from
10.0sto18.0s. - Second lane change from
18.5sto30.0s.
- First lane change from
Merge
Combine multiple consecutive events into one single event.
Example:
- Two events (
15.0sto16.5sand16.7sto18.5s) are actually part of the same lane change → merge into one event from15.0sto18.5s.
Replay
Re-watch the current event in Daredeevil from its exact start frame.
Examples:
- You validated an event but want to double-check → replay it.
- You corrected the timing and want to see if the new start time matches → replay it.
Undo
Cancel your last change. This restores the event list to its previous state.
Examples:
- You accidentally validated the wrong event → undo.
- You corrected start time but typed the wrong value → undo.
Report
See a summary of your progress: how many events are validated, corrected, invalidated, etc.
Example:
- End of session: check the report to see you reviewed 120 events, with 80 validated, 30 corrected, and 10 still invalidated.
5. Filtering events
On the left, you can use filters to find events:
- By duration (longer/shorter than X seconds).
- By event type.
- By capsule name (contains certain text).
- By status (Validated / Corrected / Invalidated).
There are quick filters for the most common cases, and personalized filters where you can filter by any column in your file.
6. Images
If your file includes an image_path column, you can display images linked to each event.
- Use relative paths if the images are in the same folder as your Excel file.
Example:screenshots:image1.png - Or use absolute paths if the images are stored elsewhere.
Example:C:\Users\Name\Desktop\img1.png
In Validrive, check the “Show image” box to enable image previews.
Example file with images
| caps | event_type | start_time | end_time | image_path |
|---|---|---|---|---|
| CERTIF_BCB_5503_ACC_20230313_095820_400Mid | lane_change | 12.0 | 17.5 | screenshots:image1.png |
| CERTIF_BCB_5503_ACC_20230313_100250_400Mid | lane_keep | 40.0 | 44.2 | C:\Users\Me\img2.png |
7. Saving results
All your changes are saved automatically into the copy of your Excel/CSV file
that Validrive created when you first uploaded it.
Your original file stays untouched.