Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HE-Extractor

Extracts audio from Humongous Entertainment .HE game files and saves them as WAV files.

Note: Only tested with Putt-Putt Saves the Zoo (PUTTZOO.HE1/HE2/HE4). Other Humongous Entertainment titles may work but are untested.

How It Works

.HE files use a hierarchical block structure (similar to RIFF/IFF) where all data is XOR-encoded with the key 0x69. The extractor:

  1. Scans each file for encoded block tags (SOUN, DIGI, TALK)
  2. Decodes block headers and locates HSHD (audio metadata) and SDAT (raw PCM data)
  3. Reads the sample rate, bit depth, and channel count from HSHD
  4. Writes a standard RIFF/WAVE file for each sound found

Usage

Place PUTTZOO.HE1, PUTTZOO.HE2, and PUTTZOO.HE4 in the same directory as the script, then run:

python3 extract_sounds.py

Extracted sounds are written to extracted_sounds/ as sound_0000.wav, sound_0001.wav, etc.

To use with a different game, edit the INPUT_FILES list at the top of extract_sounds.py.

Requirements

Python 3 — no external dependencies.

License

MIT — see LICENSE.

About

Sound file extractor for .HE (Humongous Games) files

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages