# VSB Editor

Vehicle Spy can save network message traffic to Vehicle Spy Binary (VSB) files using [Messages](https://docs.intrepidcs.com/vspy-3-documentation/3.9.12/vehicle-spy-main-menus/main-menu-spy-networks/messages-view/messages-view-top-toolbar/save-the-buffer) view, [capture function blocks](https://docs.intrepidcs.com/vspy-3-documentation/3.9.12/vehicle-spy-main-menus/main-menu-scripting-and-automation/function-blocks/function-blocks-types/capture-type-function-block/capture-type-function-block-storage-tab), or [Data Cache Disk Streaming](https://docs.intrepidcs.com/vspy-3-documentation/3.9.12/vehicle-spy-main-menus/main-menu-setup/data-cache-disk-streaming). One benefit of the [VSB file format](https://docs.intrepidcs.com/vspy-3-documentation/3.9.12/vehicle-network-interface-hardware/vehicle-spy-vsb-file-spec) is its smaller size compared to other file types.VSB files do NOT store decoded signals or user notes. Also, VSB files are not easy to read with standard file editors; so use File > [Review Buffer](https://docs.intrepidcs.com/vspy-3-documentation/3.9.12/vehicle-spy-main-menus/main-menu-file/review-buffer) to read them.

VSB files can be changed with the VSB Editor in the following ways:

* Split one VSB file into smaller files.
* Combine multiple VSB files into one file.
* Remap networks within a VSB file.

The VSB Editor is opened from the Tools > [File Conversions](https://docs.intrepidcs.com/vspy-3-documentation/3.9.12/vehicle-spy-main-menus/main-menu-tools/utilities-file-conversions) menu.

### Split VSB

Use the Split VSB tab (Figure 1) to split one VSB file into multiple smaller VSB files:

1. Enter the **Number of messages per VSB** to set how big each of the split files will be.
2. Click **Select File** and pick the VSB source file to split.
3. Click the second **Select File** and pick the Output Location for the split VSB file.
4. Click **Split VSB** to split the file according to the settings made.

The bottom area shows the status of split actions being performed. Vehicle Spy puts the split VSB files in the same directory as the source file.Each split file name is the source file name appended with a sequence number.

![Figure 1: The VSB Editor can split one VSB file into smaller files.](https://2280262322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC3KyOmcYmM6ZVd3OQDa1%2Fuploads%2FUWwCo8j12Mc0zJnGjZ3f%2FVSBEditorSplitVSB.gif?alt=media\&token=1a734475-d1e8-43a1-bc7c-e7a78fd7968e)

### Combine VSBs

Use the Combine VSBs tab (Figure 2) to combine all VSB files within a directory into one VSB file:

1. Click **Select Path** and pick the directory that has the VSB source files to combine.
2. Enter a **Combined VSB Name** (without extension) for the final combined file.
3. Click **Combine VSBs** to pull the files together.

The bottom area shows the status as the VSB files are joined together.Vehicle Spy puts the combined VSB file in the same directory as the source files.

![Figure 2: The VSB Editor can combine multiple VSB files into one file.](https://2280262322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC3KyOmcYmM6ZVd3OQDa1%2Fuploads%2FeztkZRlCEwBnDZ9YiP5H%2FVSBEditorCombineVSBs.gif?alt=media\&token=f5e08126-90c9-459f-9d79-2d620fc60ccd)

### Remap VSB

Use the Remap VSB tab (Figure 3) to change network assignments within a VSB file:

1. Click **Select Path** and pick the VSB file to be remapped.
2. Click **Scan VSB** to update the "From" column with the networks currently in the VSB file.
3. Select desired networks in the "To" column. (Figure 1:![](https://cdn.intrepidcs.net/support/VehicleSpy/assets/smOne.gif))
4. If needed, use **Reset Mapping** to reset all "To" networks back to their original "From" settings.
5. Click **Remap VSB** to make a new VSB file with the remapped networks in the "To" column.

The bottom area shows the status of remapping actions being performed.Vehicle Spy puts the remapped VSB file in the same directory as the source file.The remapped VSB file name is the source file name appended with the text "Remapped" to avoid overwriting the original file.

**Show All Networks** is not needed for remapping a VSB file, so do not use it.

![Figure 3: The VSB Editor can remap the networks within a VSB file.](https://2280262322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC3KyOmcYmM6ZVd3OQDa1%2Fuploads%2F45cBiF1guCTAF6ucsH9B%2FVSBEditorRemapVSB.gif?alt=media\&token=dda54834-8fcb-4e5c-93dd-bdbcbd6dd5e4)

### Timestamps Pre/Post

Use the Timestamps Pre/Post (Figure 4) to edit a VSB file based on a trigger time:

1. Click **Single File** or **Directory (multiple files)** to edit either a single file, or all the files in a directory
2. Enter a timestamp and click **Add**, or click on **Add Timestamp File** to add a timestamp to be used to evaluate Pre/Post times.
3. Click on **Input Location** to select either a file if **Single File** is selected, or a directory if **Directory (multiple files)** is selected.
4. Set the Pre and Post trigger times to be captured under **Pre timestamp (s)** and **Post timestamp (s)** respectively
5. Select **To individual timestamp files** to capture each trigger event to a seperate file, or select **To a Single Timestamp file** to capture all trigger events as one file.
6. Click on **Run** to edit the selected VSB file to the parameters set above.

The bottom area shows the status of the Pre/Post collection as it is being processed.

![Figure 3: The VSB Editor can remap the networks within a VSB file.](https://2280262322-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC3KyOmcYmM6ZVd3OQDa1%2Fuploads%2FSEKzzvNldrzv4tdbzkl8%2FVSBEditorPrePostVSB.gif?alt=media\&token=80954c6a-bfff-4401-b37a-bded0bfd7640)