Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:FSB (FMOD sound bank)

From ReverseEngineering.wiki
Format
Developer Firelight Technologies
Magic FSB5 (46 53 42 35); FSB1..FSB4
Extensions .fsb, .snd (Unity/Alchemy), .bank
Endianness little (FSB5 always); PCM data may be big-endian on consoles
License proprietary format; readers: vgmstream (ISC)
On this wiki Facts · Code · Notes · Topics

Sound bank container of FMOD (Firelight): FSB1 to FSB4 (magic FSB1..FSB4, bit-flag sample headers) and FSB5 (magic FSB5, packed 64-bit sample headers with typed extra chunks), also embedded in FMOD Studio .bank files.

Identification

  • Magic at offset 0: ASCII FSB5 (FMOD Studio / FMOD Ex 4.4+ era and later) or FSB1 to FSB4 (older FMOD Ex / FMOD 3). Extensions: .fsb, .snd (Unity games, Alchemy engine), .fsb.ps3; the same FSB5 data is also inside .bank files, see Format:FMOD bank (RIFF FEV).
  • FSB5 files are exactly base header + sample header size + name table size + sample data size bytes long: all four sizes are in the header, so a sum check is a cheap validity test (vgmstream rejects files where it fails).
  • A file is a bank of many sounds (subsongs); the sounds are normally streamed or loaded by name or index from the FMOD API.

FSB5 layout

All fields little-endian. See Fact:FSB (FMOD sound bank)/struct/FSB5 header and Fact:FSB (FMOD sound bank)/struct/FSB5 sample header.

  1. Base header (0x3C bytes for version 1, 0x40 for version 0): FSB5, version (0 is rare, 1 normal), number of samples, size of the sample header section, size of the name table, size of the sample data, one codec id for the whole bank, flags, a 128-bit hash and a 64-bit sub-hash.
  2. Sample headers: one per sound, variable size. The first 8 bytes are a packed 64-bit word: bit 0 = extra chunks follow; bits 1-4 = sample rate index; bits 5-6 = channels code; bits 7-33 = offset into the data section divided by 32; bits 34-63 = number of samples. Then zero or more 32-bit extra-chunk headers each followed by its payload.
  3. Name table (optional): an array of 32-bit offsets (relative to the table start) to NUL-terminated names.
  4. Sample data: sounds back to back, each starting at a multiple of 32 bytes; a sound's size is the next sound's offset minus its own (the last ends at the end of the data section).

Sample rate index: 0 4000, 1 8000, 2 11000, 3 11025, 4 16000, 5 22050, 6 24000, 7 32000, 8 44100, 9 48000, 10 96000 (11-15 invalid). Channels code: 0 mono, 1 stereo, 2 six, 3 eight; any other layout (and any other rate such as 3000, 64000, 192000) uses code 0 plus an extra chunk of type 1 (channels) or 2 (rate).

Extra chunks

Each is a 32-bit word: bit 0 = another chunk follows, bits 1-24 = payload size, bits 25-31 = type. Types seen by vgmstream: 1 channels (u8), 2 sample rate (s32), 3 loop (start, end; the end is stored minus one), 4 comment, 5 unknown 32-bit, 6 XMA seek table, 7 GameCube DSP coefficients, 8 ATRAC9 4+ channel config, 9 ATRAC9 config, 10 XWMA config, 11 Vorbis setup id and seek table, 13 peak volume float, 14 Vorbis layer count (multichannel, about 2021), 15 Opus data size. See Fact:FSB (FMOD sound bank)/enum/FSB5 extra chunk types.

FSB5 codec ids

0 none, 1 PCM8, 2 PCM16, 3 PCM24, 4 PCM32, 5 PCM float, 6 GameCube ADPCM (DSP), 7 IMA ADPCM, 8 PS2 VAG, 9 Vita HEVAG, 10 XMA, 11 MPEG (MP2/MP3 frames), 12 CELT, 13 ATRAC9, 14 XWMA, 15 Vorbis, 16 FADPCM (FMOD's own ADPCM, 0x8C-byte blocks), 17 Opus. See Fact:FSB (FMOD sound bank)/enum/FSB5 codec ids. The Vorbis codec stores raw packets without Ogg pages and without the setup header: the extra chunk 11 gives a setup id that selects a codebook set that FMOD carries internally, so the data cannot simply be wrapped in Ogg (see Notes:Vorbis/2026-10-17 Vorbis without Ogg in game middleware 96cf).

FSB1 to FSB4

The older versions share one layout (the FSB5 style is a different format): a header with the number of samples, the sample-header size, the data size, a version (0x00030000 3.0, 0x00030001 3.1, 0x00040000 4.0) and a bank-wide mode flag word, then fixed-layout sample headers whose codec is a bit mask from FMOD 3: for example FSOUND_MPEG 0x200, IMAADPCM 0x400000, VAG 0x800000, XMA 0x1000000, GCADPCM 0x2000000, 8BITS 0x8, UNSIGNED 0x80, CELT 0x8000000. Bank-wide flags: 0x1 original format kept, 0x2 basic headers, 0x4 encrypted, 0x8 big-endian PCM, 0x10 not interleaved, 0x20/0x40 MPEG frames padded to 2/4 bytes. Encrypted banks (flag 0x4) need a key held by the game; keys are out of scope here.

Layouts: Fact:FSB (FMOD sound bank)/struct/FSB2-FSB4 base header (0x10, 0x18 and 0x30 bytes for FSB2, FSB3, FSB4; FSB1 has its own 0x10-byte header with a single sample), Fact:FSB (FMOD sound bank)/struct/FSB3 FSB4 sample header (minimum 0x40, or 0x50 for FSB3.1 and FSB4; the first u16 is the header size, so extra data such as DSP coefficients follows when it exceeds the minimum), the mode word enum Fact:FSB (FMOD sound bank)/enum/FSOUND mode flags and the bank flags Fact:FSB (FMOD sound bank)/enum/FSB1-FSB4 bank flags and versions. vgmstream picks the codec in the order MPEG, IMAADPCM, VAG, XMA, GCADPCM, CELT, 8-bit PCM, else 16-bit PCM, and treats XMA as XMA1 unless the version is 4.0 (XMA2).

Tools

vgmstream reads all versions and plays any subsong; FMOD's own fsbank tool writes them. See the repository entry below.

Related

Library:FMOD, Format:FMOD bank (RIFF FEV), Technique:Game audio and video middleware, Format:Ogg, Format:Vorbis.

Code & repositories

  • https://github.com/vgmstream/vgmstream @ db77f98f405a45ad08df98aa444cae3848f95e6c · license: ISC (declared by the contributor; GitHub's detector did not recognize COPYING)
    vgmstream (ISC): reads FSB1-5, FMOD banks, Wwise WEM/BNK, Bink audio, CRI ADX/HCA/AWB/CPK/USM; the parsers in src/meta document the formats.
    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

Evidence & references

  • vgmstream commit db77f98f405a45ad08df98aa444cae3848f95e6c (ISC license): src/meta/fsb5.c (parse_header, codec switch), src/meta/fsb.c (FSB1-4 flag tables).