SithCodec 1.1.0

   (6 reviews)

4 Screenshots

About This File

Introduction
The audio files of Star Wars: Knights of the Old Republic and Star Wars: Knights of the Old Republic II – The Sith Lords (KOTOR) contain extra headers of what seem to be superfluous data that obfuscate access to the original audio outside of the video games. Most audio software will refuse to open the files, or interpret the extra bytes as audio data, leading to glitches. It has also been observed anecdotally that files lacking an appropriate header may fail to playback in certain releases of the games.

SithCodec is an application that can automatically detect and remove an extraneous header from a KOTOR audio file, or alternatively prepend a KOTOR header to a standard audio file and allow for the introduction of new audio content to these games.

Running SithCodec

  • SithCodec requires Windows (32-bit or 64-bit).
  • Make sure to extract SithCodec to a folder where you have read & write permission.
  • The code is not signed (because code signing costs an extortionate amount of money) so your firewall may warn you about running an unrecognized application.

Commands
Commands in SithCodec are executed by combining keywords into certain command sequences that the application recognizes. Input may be passed as command-line arguments when SithCodec is launched, or entered manually through a command- line interface if the application is launched without any command-line arguments.

Keywords may be entered in short form (dash followed by a single letter) or long form (double dash followed by a full word).

SithCodec keywords are not case sensitive, butdepending on your operating systemother data that you input may be, such as the names of files.

Help Screen

Entering -h or --help will display the help screen, showing a list of all keywords and their function.

    -d, --decode                decode audio
    -e, --encode                encode audio
    -f, --format                set output audio format
    -m, --music                 streammusic format
    -s, --sfx                   streamsounds format
    -v, --vo                    streamwaves/streamvoice format
    -a, --all                   all files
    -l, --list                  list files & formats
    -i, --in                    input path
    -o, --out                   output path
    -h, --help                  display this menu
    -c, --commands              display list of commands
    -x, --examples              display example commands
    -q, --quit                  exit application

Commands Screen

Entering -c or --commands will display a screen with the list of all valid commands.

    -d -i=[input path]
    -d -i=[input path] -o=[output path]
    -d -a
    -d -a -i=[input path]
    -d -a -o=[output path]
    -d -a -i=[input path] -o=[output path]
    -e -f -[format] -i=[input path]
    -e -f -[format] -i=[input path] -o=[output path]
    -e -a -f -[format]
    -e -a -f -[format] -i=[input path]
    -e -a -f -[format] -o=[output path]
    -e -a -f -[format] -i=[input path] -o=[output path]
    -l
    -l -i=[input path]
    -l -o=[output path]
    -l -i=[input path] -o=[output path]

Examples Screen

Entering -x or --examples will display some example commands.

Encode all files in SFX format from the input path, to the output path:

    -e --all -f --sfx- -i=in_folder -o=out_folder

 Decode a file, outputting to a new file:

    -d -i=oldfile.old -o=newfile.new

Decode a file without specifying output, possibly overwriting the original:

    -d -i=file.wav

List all files & formats in a given directory, printing to the console:

    -l -i=my_folder

List all files & formats in the current directory, printing to a file:

    -l -o=file.txt

Batch Files

SithCodec comes with batch files that are set up with commands for some common operations.

decode.bat
This file will decode all files located in a folder called "in" (no matter what their format) and save the new files in a folder called "decoded".

encode_music.bat
This file will encode all files located in a folder called "in" and save the new files in a folder called "music".

encode_sfx.bat
This file will encode all files located in a folder called "in" and save the new files in a folder called "sfx".

encode_vo.bat
This file will encode all files located in a folder called "in" and save the new files in a folder called "vo".

Copyright

SithCodec 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 3 of the License, or (at your option) any later version.

SithCodec 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 SithCodec. If not, see https://www.gnu.org/licenses/.

All trademarks (including logos and icons) are used for identification purposes only and are the property of their respective owners.

Star Wars and related items are trademarks and/or copyrights of Lucasfilm Ltd. SithCodec is not affiliated with or endorsed by Lucasfilm Ltd., their subsidiaries, associates, or employees, or any Star Wars license holder.

Donations

If you enjoy my mods and would like to show your support in a monetary manner, you may do so via PayPal with this donation link.

For various legal and ethical reasons, this is entirely optional and is not a requirement to downloading or using any of my mods. I also do not create specific mods for hire.

I make mods as a hobby and will most likely do so regardless of any donations or lack thereof, but modding does take up a lot of my time and every bit helps.


What's New in Version 1.1.0   See changelog

Released

  • Improved file write operations by utilizing the temp folder with a unique, random temporary path.
  • Preserved folder hierarchies during batch encode and decode operations to allow for outputting nested folders.
  • Stopped the program from being annoying about missing output folders when it could reasonably create the folder.
  • Like 7
  • Thanks 1
  • Light Side Points 2



User Feedback

You may only provide a review once you have downloaded the file.


Thor110

   3 of 3 members found this review helpful 3 / 3 members

Perfect timing, I have been needing to decode / trim a large amount of audio files for a while.

It works perfectly, Thank You for this amazing tool!

  • Thanks 1

Share this review


Link to review
todevuch

   1 of 1 member found this review helpful 1 / 1 member

In my opinion, this is one of the most underrated and coolest modding tools in kotor! Today, due to the lack of the necessary knowledge, I "racked my brains" all day, trying in vain to hear the necessary voices. With this program it became possible! Thank you, @JCarter426!

  • Thanks 1

Share this review


Link to review
Ashton Scorpius

   1 of 1 member found this review helpful 1 / 1 member

Thanks for this. No more workarounds to be able to read the files and I can finally switch to better software for audio editing.

  • Thanks 1

Share this review


Link to review
Leilukin

  

Thank you very much for making this. This tool is a lifesaver for modding audio files for the KotOR games, because now we no longer need to go through the hassle of hex editing each file manually just to be able to play and edit the audio, and then make them readable by the games.

  • Thanks 1

Share this review


Link to review
skpy

  

This is exactly what I've been needing all night. Really great work. Thank you, JC

  • Thanks 1

Share this review


Link to review
sovietshipgirl

  

JC has been a powerhouse that helps keep this modding community alive in this time of uncertainty, and I offer my full thanks and gratitude.

  • Thanks 1

Share this review


Link to review