RSCacheTool/readme.md

#RSCacheTool

######A command line tool written in C# for extracting and manipulating RuneScape's cache files.

A pre-compiled binary is available for [download from my website](https://villermen.com/browser/?d=rscachetool). Just run the tool without arguments and it will tell you the available options.

####RSCacheTool can:

 - Extract the entire cache or just one archive into separate files in a given directory. Decompressing and handing out extensions where appropriate.
 - Combine sound chunks (.ogg) from a given archive into full-fledged soundtracks. It can even give them their in-game name based on another file from the archive.
 
####Usage examples:

 - Get help: `rscachetool`, done.
 - If you're aiming only at ripping named complete music from your cache these are your 2 golden commands: `rscachetool -e=40 -c` and `rscachetool -e=17 -n`.
 - Extract all archives, combine music (including incomplete) and try to name the tracks `rscachetool -e -c -i -n`.
 - Recombine sound 21713.jaga extracted to D:\cache and rename it `rscachetool -c -f=21713 -o -n=21713 D:\cache`. (Basically this tries to fix a file if SoX mangled it before.)

####RSCacheTool makes use of the following tools and libraries:

 - [NDesk.Options](http://www.ndesk.org/Options), a command line argument parser.
 - [SharpZipLip](http://icsharpcode.github.io/SharpZipLib/), a .NET zipping library. Used to decompress archive files
 - [SoX](http://sox.sourceforge.net/) (not included in repository), a command line utility for editing sound files. Used to merge soundchunks.