Skip to content

auracomp 2.0

Latest

Choose a tag to compare

@Venomalia Venomalia released this 03 Apr 20:35

auracomp is a simple and fast command-line tool for compressing and decompressing files using the formats supported by AuroraLib.Compression.
It supports automatic format detection for decompression and a wide range of supported algorithms commonly used in video games.

Quick Use (Drag & Drop)

To quickly decompress a file, simply drag and drop it onto auracomp.exe.
The tool will automatically detect the format, and if successful, create an output file next to the input file with ~output appended to its name.

Usage

 -decompress    (-d)                   Decompress a file.
   -in          (-i)  <file path>      Input file path.
   -out         (-ou) <file path>      Output file path. [optional]
   -algo        (-a)  <name>           Algorithm/format name or MIME Type. [optional]
   -scan        (-sc)                  Scan input file for all valid compressed streams and extract them. [optional]
   -overwrite   (-o)                   Overwrite output file if already exists. [optional]
   -quiet       (-q)                   Suppress all output except errors. [optional]

-compress       (-c)                   Compress a file using the specified algorithm.
   -in          (-i)  <file path>      Input file path.
   -out         (-ou) <file path>      Output file path. [optional]
   -algo        (-a)  <name>           Algorithm/format name or MIME Type
   -level       (-l)  <0-15 or level>  CompressionLevel <Optimal, Fastest, NoCompression> [optional]
   -maxwindow   (-mw) <1-28>           sets the largest window the encoder is allowed to use. [optional]
   -legacymode  (-lm)                  Use compatibility features for older or simpler decoders [optional]
   -overwrite   (-o)                   Overwrite output file if already exists. [optional]
   -quiet       (-q)                   Suppress all output except errors. [optional]
   -endian      (-e)  <Little|Big>     Byte order [optional, format-specific]
   -wram        (-wr)                  Use WRam mode [optional, format-specific]

 -mime          (-m)                   Try to recognize the file format used.
   -in          (-i)  <file path>      Input file path.

 -bruteforce    (-bf)                  Test all algorithms until one matches the expected decompressed size.
   -in          (-i)  <file path>      Input file path.
   -size        (-s)  <number>         Expected decompressed size in bytes.
   -offset      (-of) <number>         Start offset of compressed data in byte. [optional]
   -quiet       (-q)                   Suppress all output except errors. [optional]

 -help          (-h)                   Show this help.

example

Unpack a file using batch

auracomp -d -in "input.lz" -out "output.bin"

Compress a file using batch

auracomp -c -in "input.bin" -out "output.lz" -algo "Yaz0" -endian "Little"

Recognize a file using batch

auracomp -mime -in "input.bin"

Try to brute-force the compression algorithm and unpack the file:

auracomp -bruteforce -in "input.bin" -offset 4 -size 102400

Runtime Requirements

  • auracomp_net10
    Cross-platform build that requires the .NET 10 Runtime to be installed.

  • auracomp_net8
    Cross-platform build that requires the .NET 8 Runtime to be installed.

  • auracomp_net6
    Cross-platform build that requires the .NET 6 Runtime to be installed.

  • auracomp_net472
    Windows-only version that runs on machines with .NET Framework 4.7.2 or later. No extra runtime installation is needed on most Windows PCs.


What's Changed in auracomp 2.0

  • level option now also accepts values from 0 to 15
  • The max lz window can now be set
  • LZ10, LZ11, LZ40, LZ60: You can now specify whether to use VRAM or WRAM distance.
  • LZ4 encoding now works as expected.
  • The time required for compression and decompression is now displayed.