gitwtfhub

wtf is mgs2-audio-tool?

romerojopro-web/mgs2-audio-tool — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · developerComplexity · 4/5Setup · moderate

TL;DR

A Python tool for browsing, exporting, and partially replacing dialogue, sound effects, and music in Metal Gear Solid 2 on PC.

Mindmap

mindmap
  root((MGS2-Audio-Tool))
    What it does
      Browse game audio
      Export to WAV
      Replace some audio
    Tech stack
      Python core
      PyQt6 interface
      UnityPy and ffmpeg
    Use cases
      Export dialogue and music
      Mod launcher music
      Research old formats
    Audience
      Modders
      Game preservationists
    Status
      MC stable
      Substance in progress

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Export a Metal Gear Solid 2 game's dialogue, music, or sound effects to WAV files for listening or archiving.

REASON 2

Replace the launcher music or dialogue lines in the Master Collection release with custom audio.

REASON 3

Study the reverse engineered file formats used by the PS2 era Substance version of the game.

What's in the stack?

PythonPyQt6UnityPyffmpeg

How it stacks up

romerojopro-web/mgs2-audio-tool0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity4/52/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs a legal copy of the game plus optional extras like ffmpeg or UnityPy for certain tabs.

Wtf does this do

This is an audio modding tool for the PC versions of Metal Gear Solid 2, covering both the 2023 Master Collection release and the older 2003 Substance edition. It gives players a way to open the game's sound files, listen to them, export them as WAV files, and in some cases replace them with custom audio. A game selector at the top of the app switches between the two supported versions and changes the color theme to match. For the Master Collection version, the tool is described as stable: it can browse and export dialogue lines and sound effect banks, and it can replace the music that plays in the game's launcher menu, which required figuring out how the game's Unity based file bundles are structured. Replacing the actual in game background music, as opposed to the launcher music, is still being researched, since that audio appears to follow the file layout from the original PS2 version of the game rather than the newer Unity based system. For the Substance version, the tool can browse and export voice lines, sound effects, music, and cutscene audio, but replacing audio in this version is not yet supported, and some of its file formats are still being reverse engineered. The tool is written in Python and includes an optional graphical interface built with PyQt6. Its core audio reading and decoding logic has no external dependencies, but two extra features need outside tools: reading the Master Collection's music bundles needs a package called UnityPy, and decoding some of the game's original dialogue audio needs the ffmpeg program installed separately. Replacing that same dialogue format requires another small external tool. Using this project requires owning a legal copy of the game, since the tool only works with a player's own installed game files rather than shipping any of the audio itself.

Yoink these prompts

Prompt 1
Explain how this tool figures out and rebuilds the Master Collection's Unity audio bundles.
Prompt 2
Walk me through the steps to replace a dialogue line using the SDT tab.
Prompt 3
What extra software do I need installed to decode the stock game's dialogue audio?
Prompt 4
Summarize the difference in what this tool supports for Master Collection versus Substance.

Frequently asked questions

wtf is mgs2-audio-tool?

A Python tool for browsing, exporting, and partially replacing dialogue, sound effects, and music in Metal Gear Solid 2 on PC.

What language is mgs2-audio-tool written in?

Mainly Python. The stack also includes Python, PyQt6, UnityPy.

How hard is mgs2-audio-tool to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mgs2-audio-tool for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.