The San Andreas Audio Toolkit (SAAT)

Current Version: 1.10

The San Andreas Audio Toolkit (SAAT) is a set of commandline tools useful for modding the PC version of the video game Grand Theft Auto: San Andreas. SAAT allows the importing of music files into SA audio streams and the importing of WAVe files into SA sfx archives. It will also necessarily allow exporting from each type of archive into individual files.

SAAT was written by Dave Schmitt (AKA "P.D. Escobar") in C++; it is an open-source program released under the GNU General Public License. It was based on the open-source program Radio Free San Andreas and uses several open-source libraries: libogg and libvorbis for Ogg Vorbis processing and libsndfile for other sound processing.

Resources

Download Locations for Version 1.10

SAAT is distributed in two primary locations.

Official Website

The official SAAT website is http://pdescobar.home.comcast.net/gta/saat/. It contains the most recent version of this README file, other documentation, and the distribution downloads.

Feedback

The main place for discussion and feedback on SAAT is its GTA Forums thread: http://www.gtaforums.com/index.php?showtopic=225049. You may also contact the author directly via email.

Documentation

Here's a very brief overview of SAAT. For more detailed documentation with some usage examples, see MANUAL.txt; for a list of changes in this version, see CHANGES.txt.

Installation (Windows Binaries):

  1. Unzip the two executables and all ini files into a useful location such as the GTASA main directory.
  2. Open a command prompt window and change to the install directory.

Usage (stream tool):

saat_stream.exe -e <stream_file(s)> <target_dir>
  Simple export mode; exports all tracks from <stream_file(s)>, storing the Ogg
  Vorbis files in an appropriately named subdirectory of <target_dir>.

saat_stream.exe -r <stream_file(s)> <target_dir> <metadata_file>
  RFSA export mode; like -e but uses contents of <metadata_file> for additional
  descriptive information to tag and name the exported files.
  Note: running RFSA mode on modified streams could lead to confusion.

saat_stream.exe -i <target_stream> <import_ini> <lookup_file>
  Import mode; creates <target_stream> based on the information and filename
  references in <import_ini>. Also updates <lookup_file> to reflect the changes

Usage (sfx tool):

saat_sfx.exe -e <archive_file(s)> <target_dir> <lookup_file>
  Export mode; exports all sounds from <archive_file(s)>, storing the WAVe
  files in an appropriately named subdirectory of <target_dir>.
  Uses <lookup_file> to help locate sounds within the archive.

saat_sfx.exe -i <target_archive> <import_ini> <lookup_file>
  Import mode; creates <target_archive> based on the information and filename
  references in <import_ini>. Also updates <lookup_file> to reflect the changes

Acknowledgements

The following people and projects have made major contributions to SAAT, whether they know it or not:

Licensing

(Please see COPYING.txt for full details.)

The San Andreas Audio Toolkit is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

The San Andreas Audio Toolkit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with the San Andreas Audio Toolkit; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA