Releases: Venomalia/AuroraLib.Compression
auracomp 2.0
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 102400Runtime 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.
auracomp 1.4
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) <level> CompressionLevel <Optimal, Fastest, NoCompression> [optional]
-lookahead (-la) <true|false> Use LookAhead [optional, format-specific]
-endian (-e) <Little|Big> Byte order [optional, format-specific]
-overwrite (-o) Overwrite output file if already exists. [optional]
-quiet (-q) Suppress all output except errors. [optional]
-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 102400Runtime 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 1.4
- New -scan flag for decompression
Added the ability to scan a file for multiple compressed streams and extract them automatically.
Example usage:
auracomp -decompress -in "input.bin" -out "output_folder" -scanauracomp 1.2
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]
-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) <level> CompressionLevel <Optimal, Fastest, NoCompression> [optional]
-lookahead (-la) <true|false> Use LookAhead [optional, format-specific]
-endian (-e) <Little|Big> Byte order [optional, format-specific]
-overwrite (-o) Overwrite output file if already exists. [optional]
-quiet (-q) Suppress all output except errors. [optional]
-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.
-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 102400Runtime 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 1.2
- Add static media types for RefPack options and LZ77 types.
- Set LZ10 minDistance to 2 for GBA LookAhead compatibility
- Add High Impact Games WAD compression support
auracomp 1.1
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]
-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) <level> CompressionLevel <Optimal, Fastest, NoCompression> [optional]
-lookahead (-la) <true|false> Use LookAhead [optional, format-specific]
-endian (-e) <Little|Big> Byte order [optional, format-specific]
-overwrite (-o) Overwrite output file if already exists. [optional]
-quiet (-q) Suppress all output except errors. [optional]
-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.
-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 102400Runtime 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 1.1
- Add brute-force decompression mode.
auracomp 1.0.1
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> Input file path.
-out (-ou) <file> Output file path. [optional]
-algo (-a) <name> Algorithm/format name or MIME Type [optional]
-overwrite (-o) Overwrite output file if already exists.
-compress (-c) Compress a file using the specified algorithm.
-in (-i) <file> Input file path.
-out (-ou) <file> Output file path. [optional]
-algo (-a) <name> Algorithm/format name or MIME Type
-level (-l) <level> CompressionLevel <Optimal, Fastest, NoCompression> [optional]
-lookahead (-la) <true|false> Use LookAhead [optional, format-specific]
-endian (-e) <Little|Big> Byte order [optional, format-specific]
-overwrite (-o) Overwrite output file if already exists.
-mime (-m) Try to recognize the file format used.
-in (-i) <file> Input file path.
-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"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 1.0.1
- Add MIME type detection #17
- Add Support for ZSTD Compression through ZstdSharp.
auracomp 1.0
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> Input file path.
-out (-o) <file> Output file path. [optional]
-algo (-a) <name> Algorithm/format name or MIME Type [optional]
-compress (-c) Compress a file using the specified algorithm.
-in (-i) <file> Input file path.
-out (-o) <file> Output file path. [optional]
-algo (-a) <name> Algorithm/format name or MIME Type
-level (-l) <level> CompressionLevel <Optimal, Fastest, NoCompression, SmallestSize> [optional]
-lookahead (-la) <true|false> Use LookAhead [optional, format-specific]
-endian (-e) <Little|Big> Byte order [optional, format-specific]
-overwrite (-o) Overwrite output file if already exists.
-help (-h) Shows this list.
example
auracomp -d -in "input.lz" -out "output.bin"auracomp -c -in "input.bin" -out "output.lz" -algo "Yaz0" -endian "Little"Runtime Requirements
-
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.