This project has been archived and moved to Codeberg.org for the sake of protesting Github's 2FA mandate for "additional security measure." I will not bend over backwards to add more headache to signing in. 2FA has been proven to be much more of a security risk like what happened to 100 million Epic Games users that were hacked by the Russians. Read up the 5 myths of 2FA if you are curious. My README has been updated and I linked my project to the other site. I shall enjoy with what power I have left on my account until December 14th when github locks it and shit hits the fan as github will soon make itself a valuable target to many bad hackers.

Wwise-Unpacker-Revamped

This github project is a fork of Vextil/Wwise-Unpacker and an inspiration/cherrypicked of other people's work that have also forked his project.

What makes this project stand out? The idea was to add support for "FLAC" and convert your game soundtracks, voices, and, sound effects to a lossless and open-source file extension without any sacrifices to your storage space unlike WAV and its proprietary nature. And as for MP3 and OGG, despite its compression, the format eventually loses information making these two not viable in the long run. That's where FLAC comes in allowing the end user to encode the ssame file and still retains great sound quality. I have not noticed the sound quality diminishing after testing the differences when playbacking songs at 24 bits per sample @ 44khz (level 5 default) vs. 16 bits per sample at 48khz (level 8). FLAC fills in many of the gaps that WAV, MP3, and OGG cannot do.

Linux Users Beware

Do Carefully consider that FLAC, vorbis, and ffmpeg are included inside of majority of linux distributions. If your OS does NOT have the following binaries, consider using one of the commands below before running one of the unpacking scripts depending on what distro or Package Manager you are using.

APT

sudo apt update                      

xargs sudo apt -y install < ~/Downloads/Wwise-Unpacker-Revamped/Linux/packages.txt

Pacman

sudo pacman -Syu

pacman -S $(echo $(cat ~/Downloads/Wwise-Unpacker-Revamped/Linux/packages.txt | cut -d' ' -f1))

Yum

sudo yum update 

xargs sudo yum -y install < ~/Downloads/Wwise-Unpacker-Revamped/Linux/packages.txt

APK (Alpine Linux)

sudo apk update

xargs sudo apk add < ~/Downloads/Wwise-Unpacker-Revamped/Linux/packages.txt

TODO List:
* Add Linux OS support √
* Build Linux Shell scripts √
* Include Linux Tools binaries √
* Test it in a Linux environment √ (Tested on Debian 12 | Kernel 6.1.0)

The idea behind supporting Linux, since Genshin Impact and some of the other games are supported through WINE, would be this eliminates the need to rely on Windows but rather make it universally available in order to unpack and convert game sound files.

• Add batch script to make easier to change FLAC compression level 1-8 √
• Merge with the unpacking script.
• Rework the Unpack to MP3 batch script (Optional) √
• Add Python support as an option to extract and decode videogame sounds/voices/OSTs (TBD)
• Rework how quickBMS extracts sounds and music; extracting to WAV using quickBMS will break playback. However extracting to .WEM will play music and allow you to convert .wem files when using foobar2k √

The unpacking was tested on Genshin Impact.

Special Thanks To:
* expl0it3r for the bnkextr v2.0
* VGMStream r1879
* Vextil/Wwise-Unpacker for sharing his original project
* FLAC v1.4.3
* QuickBMS v0.12.0.0
* Trust04zh for the unpack to wav bat
* hcs64 for the ww2ogg 0.24 source code
* April for the revorb source code on non-Windows platforms