unvivtool is a VIV/BIG decoder/encoder for uncompressed BIGF, BIGH, and BIG4 archives. unvivtool is available as command-line interface, and as Python extension module. It is based on a dependency-free header-only library written in C89. Python bindings are written in CPython. Supported on Windows and Linux. Tested on macOS.
Purported VIV/BIG archives can contain faulty or manipulated header information. unvivtool is designed to validate and recover data as much as possible.
Developers can drop-in and use, the encoder/decoder and some data analysis functions from libnfsviv.h.
- decode and encode archive
- validate archive
- decode entire archive
- encode files in specified order
- support UTF8 names in archive
- drag-and-drop mode for command-line interface
- option: auto-rename duplicated filenames on decode
- option: retrieve a single file from archive (by index or filename)
- option: list archive contents without writing to disk (dry run)
- option: support non-printable filenames in archive (Base16 representation)
- option: decode/encode with set fixed directory entry length
- Win98 compatibility
- memory usage typically peaks below 20 kB even for large archives; worst case ~25 MB
The supported formats are called BIGF, BIGH, and BIG4 (equals first 4 bytes).
Typical file extensions are .VIV and .BIG.
Archives can be arbitrarily large and can contain arbitrarily many entries.
Command-line interface: /cli/README.md
Python extension module: /python/README.md
The canonical BIGF format description was taken from [1]. Fixed directory entry length and format deviations, own work.
[1] D. Auroux et al. The unofficial Need For Speed III file format specifications - Version 1.0 [1998]
unvivtool License: GNU General Public License v3.0+
Website: https://github.com/bfut/unvivtool
Third party licenses
UTF-8 Decoder dfa.h: MIT License
LIBNFSVIV_CircBuf libnfsviv.h: zlib License (portions copyright)
sclpython.h: zlib License