Audio extraction tool for Puppeteer (PS3) .sgb files

---

Overview

This tool extracts audio streams from Puppeteer's .sgb container files and converts them to Dolby Digital AC3 format with optional WAV conversion support.

What it does

• Extracts audio streams from Puppeteer's .sgb container files
• Outputs to Dolby Digital AC3 format
• Optional WAV conversion with FFmpeg support
• Organized file naming with audio type classification

---

File Location

Note
The .sgb files can be found in your Puppeteer game directory:

game/NPUA80959/USRDIR/data/sound/stream

---

Requirements

Component	Version	Purpose
Python	3.6+	Core functionality
FFmpeg	Latest (optional)	WAV conversion

Installation Instructions

Python 3.6+

• Windows: Download from python.org
• macOS: brew install python3 or download from python.org
• Linux: sudo apt install python3 or sudo yum install python3

FFmpeg (Optional)

• Windows: Download from ffmpeg.org
• macOS: brew install ffmpeg
• Linux: sudo apt install ffmpeg or sudo yum install ffmpeg

---

Usage

Step 1: Run the extractor

python stringpuller.py

Step 2: Enter the path when prompted

*GAMEID*/USRDIR/data/sound/stream

---

Output Structure

The tool creates an organized output directory structure:

extracted_puppeteer_ac3/
├── AC3 Files (Dolby Digital)
│   ├── filename_01_music.ac3
│   ├── filename_01_ambient.ac3
│   └── filename_01_demo.ac3
└── wav_converted/ (Optional)
    ├── filename_01_music.wav
    ├── filename_01_ambient.wav
    └── filename_01_demo.wav

Audio Type Classification

File Pattern	Audio Type	Description
*_music.ac3	Background Music	Soundtrack and musical score
*_ambient.ac3	Environmental	Atmospheric sounds and ambient audio
*_demo.ac3	Cutscenes	Demo and narrative audio sequences

---

Technical Details

Supported Formats

Input: .sgb (Puppeteer container files)
Output: .ac3 (Dolby Digital) + .wav (optional)

Performance Notes

• AC3 files maintain original audio quality
• WAV conversion provides broader compatibility
• Processing time varies with file size and system performance

---

Troubleshooting

Warning
Ensure you have read access to the Puppeteer game files

Tip
AC3 files can be played directly in VLC, Windows Media Player, and most modern media players

---

License

This tool is intended for personal use with legally owned copies of Puppeteer.
Audio content remains property of the original developers.

---