A parser for Unity binary assets files.
Switch branches/tags
Nothing to show
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
libs/gdtoa Use -fvisibility=hidden flag when building gdtoa Oct 18, 2014
src Replace iostream with cstdio Oct 18, 2014
.gitignore Ignore generated cmake files Oct 5, 2014
CMakeLists.txt Fix decimal display of floating point values in json Oct 5, 2014
LICENSE.txt Add MIT license Oct 5, 2014
README.md Add diff command Oct 9, 2014

README.md

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.