descaniverse - read and convert Scaniverse raw data

😎 😎

descaniverse is a Python library and CLI tools for reading and converting Scaniverse raw data. The data format is reverse engineered and thus all data is not necessarily available.

Getting Scaniverse raw data

Scaniverse optionally records "raw data". This has to be enabled for this to work. Non-raw data can be mostly exported directly from the app.

Scaniverse doesn't support exporting raw data and it can't be read from the device using the usual tools (e.g. ifuse) to read files from iPhone/iPad¹.

With older iOS versions the data can be accessed by creating a backup of the device using idevicebackup2) and extracting it using ideviceunback. The scans can be found in /Library/Application Support/scans/ of the extracted backup. For newer iOS versions try iOSbackup.

Alternatively, you can probably access these easily on jailbroken device. If you know a nicer way to access these files (without jailbreak), please leave an issue.

Install

pip install git+https://github.com/jampekka/descaniverse

Usage

A CLI interface is included as descaniverse runnable.

usage: descaniverse [-h] {to_json,to_nerfstudio} ...

positional arguments:
  {to_json,to_nerfstudio}
    to_json             Converts Scaniverse metadata as-is to JSON
    to_nerfstudio       Converts a Scaniverse scan to nerfstudio format

optional arguments:
  -h, --help            show this help message and exit