Skip to content

Commit

Permalink
Updated README.md file
Browse files Browse the repository at this point in the history
  • Loading branch information
hpxro7 authored Oct 1, 2018
1 parent ab25538 commit c8e4355
Showing 1 changed file with 37 additions and 1 deletion.
38 changes: 37 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,38 @@
# bnkutil
Tools for unpacking and repacking Wwise SoundBank files.
`bnkutil` is a tool for manipulating Wwise SoundBank files (`.bnk` or `.nbnk`). It currently supports two modes:

__unpack__: This takes an input SoundBank file and writes all of the embedded `.wem` files to a directory.
[ww2ogg](https://github.com/hcs64/ww2ogg/releases) can then be used to convert the `.wem` files to a playable Ogg Vorbis format.

__repack__: This takes an input SoundBank file, along with target `.wem` files and writes a new SoundBank with target wems replaced. Audiokinetic's [Wwise](https://www.audiokinetic.com/download/) tool can be used to convert any `.wav` of your choice into the `.wem` format for audio replacement.

## Usage
### Unpack

To unpack a SoundBank file use the following command:

```bash
bnkutil.exe -unpack -bnkpath em118_vo.nbnk -output em118\
```

`-b(nkpath)` specifies the path to the `.bnk` or `.nbnk` file to unpack.

`-o(utput)` specifies the new directory that will be created to unpack the `.wem` files into.

### Repack

To repack a SoundBank file use the following command:

```bash
bnkutil.exe -repack -bnkpath em118_vo.nbnk -target wems\ -output newbank.nbnk
```
`-b(nkpath)` specifies the path to the `.bnk` or `.nbnk` file to use as a source for the repacking; replacement wems will replace the wems inside of this SoundBank.

`-t(arget)` specifies a path to a directory that will be used to gather wem replacements. This directory will be searched for all compatible `.wem` files. Their filenames will be used as an index to the target wems to replace, starting at 1. For example, a `002.wem` file in this directory will replace the second wem in the original source SoundBank with the contents of that file. To file out what the indexes are for each `.wem` file in a SoundBank, first run the unpack command.

`-o(utput)` specifies the path to the new SoundBank file to create, with replacements applied.

## Limitations

1. This software has not been thoroughly tested yet and isn't gaurenteed to work with all SoundBank files. Do [file a bug](https://github.com/hpxro7/bnkutil/issues/new) on this github page if you encounter a problem.
2. Replacing wem files that are _larger_ than their original source wem file is currently not supported. This will be supported in the near future.

0 comments on commit c8e4355

Please sign in to comment.