Broadcast WAV bext chunk

Field-by-field layout of the Broadcast Wave bext chunk: description, originator, date, time reference, UMID, loudness and coding history.

What bext is

Broadcast Wave Format (BWF), defined in EBU Tech 3285, is a normal WAV file with an extra bext chunk. It records a description, who made the file, when, a time reference for placing it on a timeline, a version number, an optional UMID, loudness values and a coding history. In the sample file it is the first chunk, before fmt .

The first 602 bytes of the payload have fixed sizes. The coding history fills the rest, so the chunk size is 602 plus the length of that text. The sample has 46 bytes of coding history, so its bext size is 648.

FieldPayload offsetHex viewBytes
Description00x08256
Originator2560x10832
OriginatorReference2880x12832
OriginationDate, yyyy-mm-dd3200x14810
OriginationTime, hh:mm:ss3300x1528
TimeReference, two 32-bit halves3380x15A8
Version3460x1622
UMID3480x16464
LoudnessValue4120x1A42
LoudnessRange4140x1A62
MaxTruePeakLevel4160x1A82
MaxMomentaryLoudness4180x1AA2
MaxShortTermLoudness4200x1AC2
Reserved4220x1AE180
CodingHistory6020x262rest of chunk
RIFF Viewer showing broadcast.wav with the bext chunk selected and its description text highlighted.
bext in the sample file with the description selected. It starts at 0x08; zero bytes fill the rest of its 256 bytes.

Time reference

TimeReference is a 64-bit count of samples since midnight, stored low half first. Divide by the sample rate for seconds. At 48 kHz, 10:00:00 is 36000 × 48000 = 1,728,000,000, stored as 00 30 ff 66 00 00 00 00. Editors use it to drop the file at the right point on a timeline.

Versions and loudness

Version 0 is the original layout. Version 1 adds the UMID. Version 2 adds the five loudness fields, each a signed 16-bit value equal to the measurement times 100. An integrated loudness of -23.00 LUFS is stored as -2300, bytes 04 f7. The sample is version 1, so its loudness bytes are zero.

Coding history

The coding history is plain text, one line per processing step, each ending in CR LF. EBU R 98 sets the line format, for example A=PCM,F=48000,W=24,M=stereo,T=..., where A is the coding, F the sample rate, W the word length and M the mode. The sample has one line ending in T=Online RIFF Tools.

The viewer shows bext as a single chunk with its bytes and ASCII text. It does not split the fields out, so use the offsets above.

Questions

What is a BWF file?

A WAV file with a bext chunk. It keeps the .wav extension, and players that ignore bext still play the audio.

How do I read the originator and date?

Select bext and read the ASCII column. The originator starts at 0x108 and the origination date at 0x148 in the hex view.

Why is the bext chunk at least 602 bytes?

The fixed fields add up to 602 bytes. Only the coding history after them varies in length.

Can ffmpeg write a bext chunk?

Yes. The ffmpeg WAV muxer has a -write_bext 1 option, which is off by default.

Open the RIFF Viewer with your own file, or download the sample used above.