WannaCRI

A (WIP) Python library for parsing, extracting, and generating Criware's various audio and video file formats. If you're interested in reading more about USM, you can read my write-up about it here

Install

Install it conventionally using

pip install WannaCRI

I recommend using uv to download and install WannaCRI. After installing uv, you can just run

uvx wannacri extractusm /path/to/usm/file/or/folder

Which will download and run the latest WannaCRI for you.

Support

This currently supports the following formats with more planned:

✅: Implemented and tested ❓: Should work but not tested ❌: Not implemented

x/y: Extract support / Create support

USM

Video

Audio

Requirements

This library has the following requirements:

A working FFmpeg and FFprobe installation. On Windows, you can download official ffmpeg and ffprobe binaries and place them on your path.

This project heavily uses the ffmpeg-python wrapper. And uses python-json-logger for logging.

Usage

If installed, there should be a command-line tool available.

For extracting USMs:

wannacri extractusm /path/to/usm/file/or/folder --key 0xKEYUSEDIFENCRYPTED

For creating USMs:

wannacri createusm /path/to/vp9/file --key 0xKEYIFYOUWANTTOENCRYPT

Licence

This is an open-sourced application licensed under the MIT License