Assets are not committed to the repo; instead, they are extracted from the ROM files as part of `make setup`.

Assets are extracted to `extracted/VERSION/assets` (for example `extracted/ntsc-1.0/assets` for the `ntsc-1.0` version), based on the descriptions stored in xml files in `assets/xml/`.

For details on the xml files contents, see [the assets xml specification file](../../tools/assets/descriptor/spec.md).

The extraction tool can use [rich](https://github.com/Textualize/rich) if installed to make output prettier.
If you are looking at output or errors from during extraction, consider installing rich for a better experience: `.venv/bin/python3 -m pip install rich`