# 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 using and distributing it.

## Running MSX Software

ROM files (ROM images)
  You can run a ROM file by double clicking it in the Finder.
DSK files (disk images)
  You can also run a DSK file by double clicking it in the Finder. Make sure you set the default machine to one that supports disks; C-BIOS does not yet have disk support. You can change the default machine by entering the console (Cmd+L) and executing for example `set machine Philips_NMS_8250`. The next time you start openMSX, the new default machine will be used. If you want to change disks without leaving openMSX, enter the console and type `diska path/to/other.dsk`.
CAS files (cassette images)
  Also CAS files can be run by double clicking them in the Finder. As for disks, you will need a default machine that supports cassettes; C-BIOS does not yet support cassettes. If you want openMSX to guess the loading instructions to start the program on the cassette automatically, type `set autoruncassettes on` in the console.

Double clicking a file in the Finder to run it in openMSX will only work if openMSX is not already running, so make sure you close it first.

To shorten the loading times of disks and cassettes, you can type `set fullspeedwhenloading on` on the console.

## 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.