Format:FSB (FMOD sound bank)
| 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) orFSB1toFSB4(older FMOD Ex / FMOD 3). Extensions:.fsb,.snd(Unity games, Alchemy engine),.fsb.ps3; the same FSB5 data is also inside.bankfiles, see Format:FMOD bank (RIFF FEV). - FSB5 files are exactly
base header + sample header size + name table size + sample data sizebytes 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.
- 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. - 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.
- Name table (optional): an array of 32-bit offsets (relative to the table start) to NUL-terminated names.
- 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).