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.

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.

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.