FEV (RIFF v. 45) Projector

Overview

Reads information from .fev and .fsb files in order to display them in a different format.

Suitable only for .fev files created using Designer 4.44.xx (or maybe some earlier versions) that are packed in the RIFF container -- using FourCC RIFF, not FEV1 like earlier versions -- and .fsb files using FourCC FSB5. The version of the RIFF's FMT chunk must be 0x00450000.

Note: Not suitable for .bank files created by Studio, which are also packed as RIFF.

The main library parses the RIFF container for the legacy FEV data, as well as most of the non-legacy chunks.

Note: At this time, the non-legacy interactive music chunk COMP and its subchunks are not handled correctly if non-empty.

The contents of the FEV can then be output in a couple of different ways, or inspected progammatically.

Binaries

Three binaries (for use on the command line) can be built at this time:

• find_fev_to_fsb_connections: Searches a directory or list of directories for files that match the FourCC RIFF or FSB5 and parses them as .fev and .fsb files, identifies the soundbank hashes the .fev files contain and the hashes of the .fsb files, and prints output determining which of the .fev files' hashes have a corresponding matching .fsb. This is useful because .fev files can reference unexpected sound banks (i.e. those that don't match their own name), or can flag a hash mismatch.

• examine_fev_data: Prints the data contained in the .fev file as a human-readable version, as well as any metadata in any referenced .fsb files. Needs to be passed a .fev filepath, as well as paths to any .fsb files that the .fev references. Such references can be determined using find_fev_to_fsb_connections.

• make_fdps_from_directories: Searches a directory or list of directories similarly to find_fev_to_fsb_connections, but instead builds a .fdp file for each .fev file using the file's data and any referenced .fsb files. These reconstructed project files can then be used by Designer together with the audio files extracted from the .fsb files to modify the audio project and build new .fev and .fsb data for that project.

Contact

Please contact me through Discord hotpocketremix or reddit HotPocketRemix if you have any questions about this project, as I very rarely check GitHub.

License

^{Licensed under either of Apache License, Version 2.0 or MIT License at your option.}