From Wiki96
Revision as of 01:54, 16 December 2022 by Ctrl (talk | contribs) (fix small mistake)
Jump to: navigation, search

A .wmx file is a virtual machine configuration file used by WMBox.This file defines exactly the specifications of the VM, and includes properties such as memory amount, attached hardware, etc.

The official Windows 96 package repository contains a wmbox-sample-vms package which contains sample VM configurations. Please note that this package is quite large, it may take a while for it to fully download.

Format

WMX files use the JSON syntax to define properties. As with any JSON file, it is recommended to use Monaco to edit them.

Here is a sample VM definition file:

{
    "meta": {
        "name": "Damn Small Linux (DSL) WMBox Demo",
        "description": "Demo file for DSL",
        "icon": "linux"
    },
    "backend": "v86",
    "memory_size": 67108864,
    "vga": {
        "memory_size": 8388608
    },
    "boot_order": 531,
    "acpi": false,
    "attachments": [
        {
            "type": "cdrom",
            "path": "./DSL.iso"
        },
        {
            "type": "keyboard"
        },
        {
            "type": "mouse"
        }
    ],
    "cmdline": null
}

Important Notes

WMBox backend not supported error
  • Currently, WMBox only implements the v86-backend. More backends are in the process of being developed.
  • Fields memory_size and vga.memory_size must report their respective sizes in bytes.
  • As of writing this article, the acpi field is still experimental for VMs using the v86-backend.
  • Current file system limitations require disk images to be resident in memory at all times. In other words, choosing a large ISO file may cause your browser to freeze if you do not have enough memory.
  • Persistent storage for disk images is not implemented, which means you cannot load a pre-existing disk image or make changes to it.