BNVIB (File Format)

BNVIB (Binary NX VIBration) is a file format used on the Nintendo Switch. It contains controller rumble data.

File Format

The file byte order is always little endian.

Metadata

The file format starts with a section that contains metadata information:

Offset	Type	Description
0x00	UInt32	Metadata size, excluding this value itself.
0x04	UInt16	Format ID. Always 3.
0x06	UInt16	Sampling rate in hertz. Always 200.
If Metadata size ≥ 0xC
0x08	UInt32	Loop start sample position.
0x0C	UInt32	Loop end sample position.
If Metadata size = 0x10
0x10	UInt32	Loop interval in samples, from the end of the loop to the start of the loop.

Vibration Data

This section contains information about the rumble sample data.

Offset	Type	Description
0x00	UInt32	Data size (S), excluding this value.
0x04	UInt32[S / 4]	Vibration sample data.

Vibration Sample Data

Each vibration value represents a sample, comprised in 4 bytes.

Offset	Type	Description
0x00	Byte	Low band amplitude.
0x01	Byte	Low band frequency.
0x02	Byte	High band amplitude.
0x03	Byte	High band frequency.

Converting Amplitude Values

The amplitude value recorded in a byte B can be converted using the following formula into an amplitude value in float:

Amplitude = B / 255

Converting Frequency Values

The frequency value recorded in a byte B can be converted using the following formula into a frequency value in float:

Frequency = 10 * 2B/32

Notes

• The default frequency for low bandwidths is 160 Hz.
• The default frequency for high bandwidths is 320 Hz.
• The conversion from audio data to vibration data is processed by resampling the audio to 8000 Hz and using either the Butterworth or Chebyshev filters (Butterworth by default). The samples are recalculated to fit with the controller's rumble sampling rate, which is 200 Hz.

Tools

The following tools can handle BNVIB files:

• (none)