Telltale Speech Extractor
By Bennyboy
Version 1.3.9
http://quickandeasysoftware.net

New in this version (1.3.9):

- Added support for Minecraft Story Mode Episodes 1 and 2. Some speech files for Jesse are also in "MCSM_pc_JesseMale101_all" and "MCSM_pc_JesseMale102_uncompressed" so you might want to open these files separately.
- Added support for Tales from the Borderlands Episodes 2-5 and Game of Thrones Episodes 2-5.
- If you have multiple Steam libraries then the program now searches all of these when autodetecting game locations.

New in the previous version (1.3.8):

- Added support for Tales from the Borderlands Episode 1 and Game of Thrones Episode 1. Added skeleton support for the remaining episodes of both games. Assuming that the file format and naming convention remain the same, new episodes should work without me needing to update the program.
- Added ability to choose individual files to extract speech from. As in previous versions you can still choose a folder and the program will automatically find the correct voice bundle to extract from. Choosing a file can be useful with newer games though as these store all the episodes in the same folder and if you choose 'open folder' the program cant know which episode you want.

What is Telltale Speech Extractor ?:
A program that enables you to rip the voices and sfx from all games released by Telltale Games. To date (October 2015) that includes:

- Back To The Future

- It's About Time
- Get Tannen!
- Citizen Brown
- Double Visions
- Outa Time

- Bone: Out From Boneville
- Bone: The Great Cow Race
- Crime Scene Investigation - 3 Dimensions of Murder
- Crime Scene Investigation - Hard Evidence
- Crime Scene Investigation - Deadly Intent
- Crime Scene Investigation - Fatal Conspiracy
- Game of Thrones

- Iron From Ice
- The Lost Lords
- The Sword in the Darkness
- Sons of Winter
- A Nest of Vipers
- The Ice Dragon (not yet released but should work)

- Hector: Badge Of Carnage

- We Negotiate with Terrorists
- Senseless Acts of Justice
- Beyond Reasonable Doom

- Jurassic Park
- Law & Order: Legacies
- Minecraft: Story mode

- The Order of the Stone
- Assembly Required
- The Last Place You Look (not yet released but should work)
- A Block and a Hard Place (not yet released but should work)
- Order Up! (not yet released but should work)

- Nelson Tethers - Puzzle Agent

- Episode 1
- Episode 2

- Poker Night At The Inventory
- Sam and Max: Season 1:

- Sam and Max: Culture Shock
- Sam and Max: Situation Comedy
- Sam and Max: The Mole The Mob And The Meatball
- Sam and Max: Abe Lincoln Must Die
- Sam and Max: Reality 2.0
- Sam and Max: Bright Side Of The Moon

- Sam and Max: Season 2:

- Sam and Max: Ice Station Santa
- Sam and Max: Moai Better Blues
- Sam and Max: Night Of The Raving Dead
- Sam and Max: Chariots Of The Dogs
- Sam and Max: What's New Beelzebub

- Sam and Max: Season 3:

- Sam and Max: The Penal Zone
- The Tomb of Sammun-Mak
- They Stole Max's Brain
- Beyond the Alley of the Dolls
- The City That Dares Not Sleep

- Strong Bad: Season 1:

- Strong Bad: Homestar Ruiner
- Strong Bad: Strong Badia The Free
- Strong Bad: Baddest Of The Bands
- Strong Bad: Dangeresque 3
- Strong Bad: 8-Bit Is Enough

- Tales From The Borderlands

- Zer0 Sum
- Atlas Mugged
- Catch a Ride
- Escape Plan Bravo
- The Vault of the Traveler

- Tales Of Monkey Island: Season 1

- Launch Of The Screaming Narwhal
- The Siege of Spinner Cay
- Lair of the Leviathan
- The Trial and Execution of Guybrush Threepwood
- Rise of the Pirate God

- The Walking Dead Season One

- Episode 1: A New Day
- Episode 2: Starved For Help
- Episode 3: Long Road Ahead
- Episode 4: Around Every Corner
- Episode 5: No Time Left
- Episode 6: 400 Days (DLC)

- The Walking Dead Season 2

- Episode 1: All That Remains
- Episode 2: A House Divided
- Episode 3: In Harm's Way
- Episode 4: Amid the Ruins
- Episode 5: No Going Back

- The Wolf Among Us

- Episode 1: Faith
- Episode 2: Smoke and Mirrors
- Episode 3: A Crooked Mile
- Episode 4: In Sheep's Clothing
- Episode 5: Cry Wolf

- Telltale Texas Hold’em
- Wallace and Gromit’s Grand Adventure

- Fright Of The Bumblebees
- The Last Resort
- Muzzled!
- The Bogey Man

What do I need to use this?:
Just the games themselves.

How to use it:

- Click Open and either click on open folder and choose a folder yourself or choose one of the games and the files will automatically be found.
- Click the Play Sound button or press enter to play the currently selected sound.
- Click Save File to save a sound. You can choose to save as a WAV or OGG file or let the program automatically choose the most appropriate format. OGG files will be tagged with the annotation text.
- Click Save All Files to save the sounds as WAV or OGG or let the program automatically choose the most appropriate format.
- Click the Annotations button to edit annotations. See the 'Annotations' section below for more information.

Filtering the sounds:

- Click on the View button to show a list of all the categories (characters), selecting one of these changes the view so that only sounds in that category are visible.
- To reset the view and show all categories, click the button again and click View All Files.

Searching the sounds:

- To search just type in the search box. Searching ignores any filter that you've used. I.e. the view will be reset to 'All Files'. The search looks in file names and annotations and is an 'instant search' - the search happens as you type.
- To reset the view either delete the text in the search box or click the View button and select View all files.

Annotations:
The sounds do not contain any textual information about their contents beyond the filename. To assist with this problem Telltale Speech Extractor supports annotations.
Annotations are descriptive names given to sounds. They list what is said and what character says it. This allows the sounds to be easily browsed, filtered and searched. They are also used when a sound is saved as an MP3. Windows imposes a limit on the length of file names, so its difficult to make a descriptive filename with the limited numbers of characters available. To counter this Telltale Speech Extractor embeds the sound's annotation inside the MP3 as an ID3 tag. This makes it much easier to identify and find the sounds in Windows and music players.
The program comes with annotations for every Telltale game currently available, they are not all 100% complete though. In some games, there are some sounds that don't have annotations, however the annotations can be changed and new ones added. Clicking the Annotations button brings up the annotation editing panel. In here you can edit annotations, change and add annotation categories. Remember to click the Save Changes button when you're done, as the annotations are not automatically saved.
If you add annotations to a game, please send me your updated annotation files so that I can add them to the next release of the program. The annotation files are just standard ini files, they can be found in the 'Annotations' folder and have the file extension '.annot'.

Bugs/Limitations:
Until very recently each episode of a game stored its resources in separate folders. However some newer games store the resources for all episodes in the same folder. The Walking Dead Season 2 and all games released since do this. If you manually choose the game folder by clicking 'open folder' then the program cant know which episode you want. To fix - either choose the specific episode from the menu or choose 'open file' and select the individual file that you want to extract speech from..
The tool only rips audio from the speech files. If you want to rip the .aud music files then download Telltale Music Extractor from my website.

Technical details:
The speech files used in Telltale games have changed over time, generally speaking there are 4 types of audio file used:

- (.VOX) Vox V1 - These use the Speex codec to store the speech, however the Speex data is not stored in a vorbis container. The audio is divided up into 'packets', some of which are encrypted.
- (.VOX) Vox V2 - These are esentially the same as Vox V1 - but the file header is different and there's no encryption.
- (.AUD) Ogg audio - These are standard Ogg files with an extra header. The format of the header is not always the same and changes between games.
- (.FSB) FSB audio - Seen in The Walking Dead and later games, these are standard FSB files.

The way the files are stored has also changed. In earlier games (those released before Strongbad) the audio files were stored individually inside the Pack\Data\ folder. However later games packed the files inside a .ttarch bundle. To get at these files you have to get them out of the bundle first.
To make things even more complicated there's also the issue of encryption. In 'VOX V1' files, packet 0 and every 64th packet are encrypted, so to get correct audio you have to decrypt these. However the encryption keys differ between games. CSI 3 Dimensions of Murder and the original releases of Sam and Max 101, Bone1, Bone2 and Texas Holdem all use the same key. However the original releases of Sam and Max 102-106 all used different keys.
In the last few years though Telltale have released updated versions of Sam and Max Season 1, Bone1, Bone2 and Texas Holdem. These now use the VOX V2 format, so arent encrypted.
To summarise, here is the crazy array of formats and containers that this program supports:

- V1 VOX files that are partially encrypted, with some games using a different key.

- CSI: 3 Dimensions of Murder, the original releases of Sam and Max 101, Bone1, Bone2 and Texas Holdem.

- V2 VOX files with a slightly different format and no encryption.

- CSI: Hard Evidence, Sam and Max Season 2, the updated releases of Sam and Max 101, Bone1, Bone2 and Texas Holdem.

- AUD (ogg) files packed inside an encrypted .ttarch bundle.

- Strongbad Season 1.

- AUD (ogg) files packed inside a different format, compressed and even more encrypted .ttarch bundle.

- The majority of games released since Strongbad.

- V2 VOX files packed inside a different format, compressed and even more encrypted .ttarch bundle.

- Poker Night At The Inventory and CSI Fatal Conspiracy.

- FSB files packed inside a compressed and even more encrypted .ttarch bundle.

- The Walking Dead and all games released since then.

Credits and thanks:

- Anders Jakobsen for his help with the FSB files
  http://aezay.site11.com
- Annotation Icon from Buff Set by Mattahan
  http://mattahan.deviantart.com
- Clear, Add and Undo icons from the TiiconCollection by Timon Freitag
  http://projects.ff22.de/tiicon/
- Delphi Speex Wrapper by Bech
  http://www.sed-p.net
- Disk and View Icons by glyFX
  http://www.glyfx.com
- Glow Buttons, Popup Menus, Status Bar and Task Dialog by TMS Software
  http://www.tmssoftware.com
- JEDI Code Library
  http://sourceforge.net/projects/jcl
- JEDI Visual Code Library
  http://homepages.codegear.com/jedi/jvcl
- MP3FileUtils by Daniel Gaussmann
  http://www.gausi.de
- Ogg Vorbis and Opus Tag Library by 3delite
  http://www.3delite.hu
- Open icon by Clever Icons
  http://www.clevericons.com
- Sam and Max Season One Annotations were fixed, updated and completed by Christoph 'Aeon' Loewe
  http://aeons.planetquake.gamespy.com
- Simon Boyes - for advice and testing
- Telltale Games
  Thanks for making such brilliant games
  http://www.telltalegames.com
- Virtual Treeview by Mike Lischke
  http://www.delphi-gems.com
- Wave Writer class by Benjamin Haisch (John_Doe)
  http://gamefileformats.netfirms.com

Support:
Contact me.
All my software is completely free. If you find this program useful please consider making a donation. This can be done on my website.

Bennyboy 29/10/15