Format:XACT wave bank and sound bank (XWB, XSB)
| Developer | Microsoft |
|---|---|
| Magic | WBND / DNBW (wave bank), SDBK / KBDS (sound bank) |
| Extensions | .xwb, .xsb |
| Endianness | little (Xbox, PC), big (Xbox 360) |
| License | proprietary; reader: vgmstream (ISC) |
| On this wiki | Facts · Code · Notes · Topics |
Microsoft XACT's two audio files: the wave bank (.xwb, magic WBND, holds the audio) and the sound bank (.xsb, magic SDBK, holds cue names and playback logic), used on Xbox, Xbox 360, Windows and XNA games.
Identification
- Wave bank (.xwb): the first four bytes are
WBNDon Xbox and Windows (little-endian fields) orDNBWon Xbox 360 (big-endian fields). vgmstream accepts the extensions xwb, xna, hwb, bd and extensionless files (Ikaruga, Grabbed by the Ghoulies). - Sound bank (.xsb):
SDBK(little-endian) orKBDS(big-endian). It carries cue names and the logic that picks waves; the .xwb carries the audio, a bank name and in most builds entry names. - The u32 at offset 4 of a wave bank is the tool version in XACT1 and XACT2 files; XACT3 files have a tool version at 4 and a header version at 8 (vgmstream comment). Microsoft only distinguishes XACT 1, 2 and 3; vgmstream splits them finer by wave bank version, see Fact:XACT wave bank and sound bank (XWB, XSB)/enum/XWB version ranges.
Wave bank layout
Fields use the byte order given by the magic. From XACT2 on the header is a table of segments (offset, length): bank data (WAVEBANKDATA), entry metadata, then depending on version entry names, extra data (XMA seek tables) and the wave data. The WAVEBANKDATA block holds flags, the entry count, a bank name (16 bytes up to v21, 64 bytes after), the size of an entry, an alignment (usually one DVD sector) and a shared format word used by compact banks. The flag bit 0x00020000 means compact entries (8 bytes per entry packing offset and size in sectors). See Fact:XACT wave bank and sound bank (XWB, XSB)/struct/XWB header and entry.
Each non-compact entry (WAVEBANKENTRY; its size is stored in the bank data) starts with flags and duration (from XACT1.1 on: flags in the low 4 bits, play length in samples in the upper 28 bits), then the format word, the offset and size inside the wave data, and a loop region (bytes in early files, samples from XACT3).
The format word is bit packed and its layout changed with the version; the codec tag is only 1 to 2 bits wide: see Fact:XACT wave bank and sound bank (XWB, XSB)/enum/XWB format tag to codec.
Sound bank
XSB versions are numbered separately from XWB. vgmstream parses the sound bank only to name streams and calls the format comically complex: the header holds cue counts, wave bank names, a name table and sound and cue entries whose layout differs per version (offsets are in the fact). See Fact:XACT wave bank and sound bank (XWB, XSB)/magic/XSB header. vgmstream rejects an XSB newer than the XWB it is paired with as a mismatch.
Code & repositories
- https://github.com/vgmstream/vgmstream @
db77f98f405a45ad08df98aa444cae3848f95e6c· license: ISC (declared by the contributor; GitHub's detector did not recognize COPYING)
vgmstream (ISC, COPYING lists ISC-style terms with portions under other notices): src/meta/xwb.c, xwb_xsb.h (XACT), acb.c, awb.c (CRI ACB/AWB), fsb5_fev.c, fsb_fev.h (FMOD banks).
Tested on: source read, not run: source read, not run · checked 2026-10-18; last activity 2026-10-16; Note: the latest release ships binaries; the wiki links only the source, never the binaries
Pitfalls
- Some games repurpose the format: Techland's XWB (version 0x10000) with the XMA2 tag and a block size of 0x60, 0x98 or 0xC0 holds ATRAC3 data (PS3); the Ogg tag of XACT1.1 banks appears in Oddworld: Stranger's Wrath mobile ports. Crackdown 1 uses version 0x87 with a mutated compact entry.
- The XWB version number is not the XACT toolkit release; use the version table.
Related
Technique:Game audio and video middleware, Format:RIFF WAVE.
Evidence & references
- vgmstream commit db77f98f405a45ad08df98aa444cae3848f95e6c (ISC):
src/meta/xwb.c,src/meta/xwb_xsb.h. Reference names given in the source: XWBtool, xactwb.h, xact2wb.h, xact3wb.h, MonoGame's Xact folder, multimedia.cx XACT wiki. Everything here comes from reading vgmstream's code; nothing was run.