Zizany - Unity binary assets parser
Parse and extract information from Unity binary assets files, for debugging, diffing or mere curiosity.
Requirements
- cmake
- clang++ or g++
Installation
$ cmake .
$ make
$ sudo make install
Commands
Dump file content as a json object
$ zizany dump [-tarpdlm] <filename>
Options :
-t
,--types
Dump structure of the stored types.-a
,--assets
Dump value of the stored assets.-r
,--file-references
Dump value of the file references.-p
,--previews
Dump value of the stored previews.-d
,--type-defaults
Dump type attributes even if they are equal to their default value.-l
,--file-layout
Dump attributes related to the internal layout of the file.-m
,--magic
Dump attributes whose meaning is not yet known.
Compare two files and print a list of differences
$ zizany diff <base_filename> <other_filename>
Extract previews as png files
$ zizany extract_previews [-o <path>] [<filename> ...]
Options :
-o <path>
,--output_dir=<path>
Select a directory where preview files will be saved.
The directory will be created if it does not already exist.
Defaults to the current directory.
Using zizany as a git filter
If for some reason you have binary assets in your source repository, you can configure git to use zizany as a text filter and display human readable diffs.
In .gitattributes
:
*.asset diff=zizany
In .git/config
:
[diff "zizany"]
textconv = zizany dump -tarp
binary = true
License
This project is licensed under the terms of the MIT license.
The gdtoa library is copyrighted by Lucent Technologies and distributed
under the terms specified in the file libs/gdtoa/LICENSE.txt
.