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.
SAAT is distributed in two primary locations.
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.
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.
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.
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
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
The following people and projects have made major contributions to SAAT, whether they know it or not:
(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