# openMSX README

## Documentation

In the `Documentation` directory you can find the documentation for openMSX. Some sections you might want to read first:

Key Mapping
  Lists which keys you need to press for special MSX key and for emulator functions.
System ROMs
  Describes how openMSX deals with system ROMs. This binary distribution has C-BIOS inside of it. Should you decide to install additional system ROMs, I suggest you put them in `~/.openMSX/share/systemroms`. That way, if you upgrade openMSX later, they will automatically be found by the new version.
Release History
  Lists the changes made in each release of openMSX. Read this to learn about new features or changed behaviour.
Authors and License
  Tells you about the people who made openMSX and the conditions for distributing it.

## Running MSX Software

ROM files (ROM images)
  Open the OSD (On-Screen Display) menu using Cmd+O, then choose "Load ROM...".
DSK files (disk images)
  Open the OSD menu using Cmd+O, then choose "Insert Disk...". Make sure you select a machine that supports disks; C-BIOS does not yet have disk support. If you installed system ROMs (see above), you can change the MSX model that is emulated in the OSD menu under "Hardware... > Change Machine...".
CAS files (cassette images)
  Open the OSD menu using Cmd+O, then choose "Set Tape...". As for disks, you will need to select a machine that supports cassettes; C-BIOS does not yet support cassettes.

Double clicking a file in the Finder to open it in openMSX unfortunately doesn't always work; this might be fixed in future openMSX versions.

To shorten the loading times of disks and cassettes, you can type `set fullspeedwhenloading on` on the openMSX console, which can be opened with Cmd+L.

## openMSX on the Web

Home Page
  Contains everything about openMSX.
Project Page on SourceForge
  You can download new versions here, or report bugs.
Forum
  Discuss openMSX with other users.