Skip to content

Latest commit

 

History

History
84 lines (51 loc) · 2.73 KB

README.md

File metadata and controls

84 lines (51 loc) · 2.73 KB
Raw

Basic .unitypackage Viewer

I just wanted a simple tool to do the following:

  • Browse the tree of a .unitypackage file
  • Extract some individual files
  • All without having to start Unity

So I threw this together for my own use. Maybe it could be helpful to others.

This is a Java program requiring Java 8 or higher.

How to use

  • Run with Java
  • Accepts a .unitypackage as a program argument to open immediately
  • Open .unitypackage files using the Open button, or drag and drop a .unitypackage onto the window
  • Search by name or GUID in the text box and press Enter or the Search button
  • Expand/Collapse the tree
  • Files with a preview will appear in the preview box
  • Extract the selected item into the same directory as the .unitypackage. The directory will be opened in your OS file viewer.
  • Right-click to copy name, size, or GUID
  • History.ini saves the last directory used

Alternatively, it can extract everything from the command line using the --extract-all command

java -jar UnityPackageViewer.x.x.x.jar path/to/file.unitypackage --extract-all

Disclaimers

  • This is beta quality software. No rigorous testing has been done. It probably has bugs. Only tested with data as I make use of it.

  • All I know about the .unitypackage file format came from examining several files, and reading code from some existing tools. I didn't read any specification (assuming there is one). There could certainly be edge cases this misses.

The .unitypackage file format

A .unitypackage is just a compressed TAR archive. Inside it contains several root directories. Each directory name is a GUID.

Inside each of them is the contents of the asset with that GUID. Specifically, each GUID directory contains some of these 4 files.

  • pathname First line of text is the full path of the asset where it will appear when imported into Unity.
  • asset.meta The corresponding .meta file.
  • asset Contains the actual asset payload. Won't exist for directories.
  • preview.png Optional preview of some types of assets.

It's not difficult to build up the structure of what's shown when you import into unity.

As shown in Unity:

As shown in this tool:

Existing open source tools I found

https://gist.github.com/yasirkula/dfc43134fbfefb820d0adbc5d7c25fb3

A very nice Unity script to explore .unitypackages.

https://github.com/Switch-9867/UnitypackgeExtractor

C# command-line tool.

https://github.com/Cobertos/unitypackage_extractor

Python command-line tool. Its associated pypi package at https://pypi.org/project/unitypackage-extractor/