Format:Wwise SoundBank (BNK)
| Developer | Audiokinetic |
|---|---|
| Magic | BKHD |
| Extensions | .bnk |
| Endianness | little (PC), big on Xbox 360/PS3/Wii U |
| License | proprietary; readers: vgmstream (ISC), wwiser |
| On this wiki | Facts · Code · Notes · Topics |
Audiokinetic Wwise's SoundBank (.bnk): a sequence of 4-character chunks (BKHD header, DIDX index, DATA wem payloads, HIRC object hierarchy, STID, STMG, INIT, ENVS ...) holding events, sounds, music and optionally the audio itself.
Identification
- The file starts with the chunk
BKHD(some Xbox 360 games prefix it with a 12-byteAKBKwrapper). Chunks are4-char id, u32 size, payload, sizes in the platform's byte order, no padding, sequentially packed; unlike RIFF the first chunk follows the same rule. - BKHD payload starts with the bank version (u32; Wwise 2007 era files have version 0 or 1 and the real version 0x10 further on), then the bank id and the language id; the version is the best date indicator: see the table under Versions. Sound-engine code branches on this version.
- Typical chunks:
DIDX(index of embedded .wem: 12-byte entries of file id, offset into DATA, size),DATA(the .wem files back to back, see Format:WEM (Wwise RIFF audio)),HIRC(hierarchy of all objects, see HIRC object types; the largest chunk and the one that defines playback),STID(bank id to name table),STMG(global settings),INIT(plugin list),ENVS,FXPR. Banks of a game's ownInit.bnkdefine buses and plugins. - In bank versions up to 26 the DATA chunk has its own embedded header in place of DIDX (entries of 0x18 bytes).
- Streamed audio is not in the bank: HIRC refers to external .wem files by id;
.pckis the package file that gathers banks and wems.
Practical
To hear or extract audio: vgmstream opens a .bnk and lists the embedded wems as subsongs; for the event logic (which sound plays on which event, loops, music) use wwiser (parses HIRC into a dump or .txtp playlists for vgmstream). Names in HIRC are 32-bit FNV-1 hashes of lower-case names; wwnames lists known names.
Related
Library:Wwise, Format:WEM (Wwise RIFF audio), Technique:Game audio and video middleware.
Versions
Bank version (u32 in BKHD) against the SDK release, from the bank_versions table of wwiser (wwiser/parser/wdefs.py, commit 08e937b649bc7007c234bbd59e34a41d5eef3b38). The version is AK_SOUNDBANK_VERSION; it grows by about 1 per breaking field change and does not track the calendar year exactly. A marker "?" means wwiser's author is unsure of the release.
| Bank version | Wwise release | Example platforms/games listed by wwiser |
|---|---|---|
| 14 | 2007.1/2? | Xbox 360 |
| 26 | 2007.3? | Xbox 360, PC |
| 34, 35, 36 | 2008.1?, 2008.2?, 2008.3? | 35 seen on Wii |
| 38 | 2008.4 | PS3, Wii |
| 44, 45, 46 | 2009.1?, 2009.2?, 2009.3 | Xbox 360, Wii |
| 48 | 2010.1 | Xbox 360, PS3 |
| 52, 53 | 2010.2, 2010.3 | Xbox 360, PS3 |
| 56 | 2011.1 | PS3, Vita |
| 62 | 2011.2 | Xbox 360 |
| 65, 70 | 2011.3?, 2012.1? | |
| 72 | 2012.2 | PC, Xbox 360 |
| 88 | 2013.1/2 | Wii U, PC |
| 112 | 2014.1 | PS3, Wii U, Android, PC |
| 113 | 2015.1 | PC |
| 118, 120 | 2016.1, 2016.2 | PS4, Switch, PC |
| 125 | 2017.1 | PC |
| 128 | 2017.2 | PC, PS4, Switch |
| 132 | 2018.1 | Switch, PC |
| 134 | 2019.1 | PC |
| 135 | 2019.2 | PC, Switch |
| 140, 141 | 2021.1 | PC |
| 145 | 2022.1 | PC |
| 150 | 2023.1 | PC |
| 154 | 2024.1 | PC |
| 168-172 | 2025.1.x (beta builds in the table) | none known |
Intermediate numbers (89, 122, 126, 129, 136, 144, 152, 160) are beta or update builds. Versions 14 and 26 are parsed only partially by wwiser. Hence the earlier statement on this page that 34-36 is 2009 and 134 is 2019 was partly wrong: 34-36 is 2008, 44-48 is 2009-2010.
HIRC object types
HIRC payload: u32 count of objects, then each object is u8 type, u32 size, body (the type was a u32 in bank versions up to 48). Type numbers, from wwiser (wwiser/parser/wdefs.py AkBank__AKBKHircType_* and the dispatch in wparser.py get_hirc_dispatch, commit 08e937b649bc7007c234bbd59e34a41d5eef3b38):
| Type | Object | Notes |
|---|---|---|
| 0x01 | State | |
| 0x02 | Sound (SFX/voice) | refers to a .wem by source id |
| 0x03 | Action | |
| 0x04 | Event | |
| 0x05 | Random/Sequence container | |
| 0x06 | Switch container | |
| 0x07 | Actor-Mixer | |
| 0x08 | Bus | |
| 0x09 | Layer container | |
| 0x0A | Music segment | |
| 0x0B | Music track | |
| 0x0C | Music switch container | |
| 0x0D | Music random/sequence container | |
| 0x0E | Attenuation | |
| 0x0F | Dialogue event |
Numbers above 0x0F shifted over time:
| Type | Bank versions up to 72 | Versions 73-126 | Version 128 and later |
|---|---|---|---|
| 0x10 | FeedbackBus | FeedbackBus | FxShareSet |
| 0x11 | FeedbackNode | FeedbackNode | FxCustom |
| 0x12 | FxShareSet | FxShareSet | Auxiliary bus |
| 0x13 | FxCustom | FxCustom | LFO modulator |
| 0x14 | Auxiliary bus | Auxiliary bus | Envelope modulator |
| 0x15 | - | LFO modulator (112+) | Audio device |
| 0x16 | - | Envelope modulator (112+) | Time modulator (132+) |
| 0x17 | - | Audio device (118+) | Sidechain mix (168+) |
wwiser's dispatcher switches at version 126/127 (the 128-and-later layout); the exact version of the switch is from its code. In 2025.1 the editor renamed Actor-Mixer to Containers, but the bank still uses type 0x07.
Facts for readers: Fact:Wwise SoundBank (BNK)/enum/HIRC object types (bank version 126 and earlier) and Fact:Wwise SoundBank (BNK)/enum/HIRC object types (bank version 127 and later) (complete value lists), Fact:Wwise SoundBank (BNK)/enum/Action types (common values) (the 16-bit Action type), Fact:Wwise SoundBank (BNK)/enum/Chunk ids, Fact:Wwise SoundBank (BNK)/enum/Language ids. Pitfall: the Sound source type values 1 and 2 swap meaning between old and new banks (1 streaming, 2 prefetch up to version 89; 1 prefetch, 2 streaming after): Fact:Wwise SoundBank (BNK)/enum/Source type (bank version 89 and earlier), Fact:Wwise SoundBank (BNK)/enum/Source type (bank version 90 and later). Media index: Fact:Wwise SoundBank (BNK)/struct/DIDX media index entry (12 bytes) and, for bank version 26 and lower, Fact:Wwise SoundBank (BNK)/struct/Old DATA chunk index (bank version 26 and earlier).
Code & repositories
- https://github.com/bnnm/wwiser @
08e937b649bc7007c234bbd59e34a41d5eef3b38· license: none
Wwise bank parser/dumper whose wdefs.py lists bank versions, chunk ids and HIRC object types
Tested on: source read, not run: source read, not run · checked 2026-10-18; last activity 2026-09-30; no license: not reusable
Evidence & references
- vgmstream commit db77f98f405a45ad08df98aa444cae3848f95e6c (ISC):
src/meta/bkhd.clines 8-140 (AKBK prefix, version handling, DIDX/DATA, old DATA layout, wmid/RIFF subfile detection). The HIRC object types and the version-to-release table were verified against wwiser (bnnm/wwiser commit 08e937b649bc7007c234bbd59e34a41d5eef3b38, wwiser/parser/wdefs.pybank_versionsandAkBank__AKBKHircType_*, wparser.pyget_hirc_dispatch; the repository has no license file, so only facts are recorded). The FNV-1 name hash is settled from wwiser/wfnv.py (names lower-cased, 32-bit FNV-1: multiply by 16777619 then xor, offset basis 2166136261): see Fact:Wwise SoundBank (BNK)/behavior/Name hash is FNV-1 of the lower-cased name.