FModBankParser 1.0.1

<div align="center">

FModBankParser

</div> <div align="center">

</div>

C# library for parsing and extracting FMOD Studio sound banks, with a primary focus on Unreal Engine projects.

FModBankParser allows you to analyze, extract, and inspect FMOD .bank files of any kind, including those used in commercial games and standalone FMOD projects. It supports a wide range of FMOD versions.

This library was originally developed for the FModel project, if you are only interested in exploring or extracting FMOD audio from UE games you should check it out first.

Disclaimer

This project was reverse-engineered by studying publicly available SDKs, documentation, and game binaries, and is not affiliated with or endorsed by Firelight Technologies in any way. All work was independently performed to better understand FMOD soundbank formats within Unreal Engine projects.

No proprietary, confidential, or internal source code from Firelight Technologies was used in the development of this library.

Features

This library is intended only for parsing, reading, and extracting FMOD .bank, .assets.bank, .streams.bank, and .strings.bank files.
It is not designed and will never be used to rebuild or modify soundbanks.

Installation

From NuGet

The easiest way to use FModBankParser is via NuGet:

dotnet add package FModBankParser

From local project

If you have a local copy of the project:

git clone https://github.com/Masusder/FModBankParser.git

You can include it directly in your .NET project:

dotnet add reference ../FModBankParser/FModBankParser.csproj

Demo CLI Usage

Project comes with an example FModBankParser.Demo that you can use.

Compile the project or download the demo executable from the Releases tab, then run it from a terminal:

FModBankParser.Demo <file_or_folder> [--key <encryptionKey>] [--export-audio] [--output <outputFolder>]

Options

API Usage Examples

Load a Single FMOD Bank

using FModBankParser;

var reader = FModBankParser.LoadSoundBank("Master.bank");

Console.WriteLine($"Soundbank: {reader.BankName} (GUID: {reader.GetBankGuid()})");
Console.WriteLine($"FMOD Version: {reader.BankInfo.FileVersion}");
Console.WriteLine($"Event count: {reader.EventNodes.Count}");

Load All Banks in a Directory

using FModBankParser;

var readers = FModBankParser.LoadSoundBanks("C:\\Games\\MyProject\\Content\\FMOD");

foreach (var reader in readers)
    Console.WriteLine($"Loaded bank: {reader.BankName}");

Audio Export

using FModBankParser;

// Load a sound bank
var reader = FModBankParser.LoadSoundBank("Master.bank")
var outDir = new DirectoryInfo("ExportedAudio")

// Export all embedded audio
var exportedAudio = FModBankParser.ExportAudio(reader, outDir);

if (exportedAudio.Success)
{
    Console.WriteLine($"Exported {exportedAudio.FilesExported} audio files to: {outDir.FullName}");
}
else
{
    Console.WriteLine($"No audio files were exported for {file.Name}.");
}

Tested FMOD Versions

<br>

Acknowledgements

• Special thanks to LongerWarrior for the help.

License

FModBankParser is licensed under Apache License 2.0, licenses of third-party libraries used are listed here.