vmu-tools 0.1.9

A set of tools for Dreamcast VMUcle icon

VMU Tools

This python project is designed to be a fully loaded suite of VMU tools for the Dreamcast.

Features

• Read and extract data from .VMS and .VMI files
• Generate icons from ICONDATA and VMS files
• Generate VMI files from VMS
• Read and manipulate VMU dumps files
• Extract and upload save games from VMU dump files
• update VMS icons from PNG and JPEG

Checkout examples.py and example files for all features

Install

pip install vmu-tools --upgrade

Examples

As a python package

import vmut

# Load .VMS file
VMS = vmut.vms.load_vms("example_files/SCALIBUR.VMS")

# Print info
print(VMS.info)

# Save icon
VMS.image_save("animaed.gif")

# Generate Checksum
print(VMS.generated_crc())

#Generate VMI
VMS.vmi_gen("test.vmi", "slurmking.com", "test VMI file")

#Fix crc
VMS.fix_crc()

Convert image to VMU Icon

For best results use a square image scaled to 32x32

vmut.Icon(image="example_files/slurm.png", threshold=160, invert=True).save()

Roadmap

• Change VMU color
• Convert VMU dumps to and from .DCI files
• Modify VMU ICONDATA from VMU dumps
• Possible GUI / Electron app
• Possibly implement a built-in webserver for file transfers from Dreamcast

---

Special Thanks to:

• Marcus Comstedt https://mc.pp.se/dc/
  • For providing the best documentation on the Dreamcast
• mrneo240
  • for assistance on creating ICONDATA tools
• bucanero
  • For providing a dump of usefull test files