openMSX Launcher v1.1

openMSX Launcher is a front-end for openMSX written in Java, and can run on Windows, MacOS, Linux and BSD.

After starting the launcher for the first time, you need to set a few fields in the settings window.

First time installation

Windows: unzip the Windows package anywhere on your system.

MacOS: open the downloaded DMG and drag "openMSX" into your "Applications" folder.

Linux/BSD: unzip the Linux/BSD package anywhere on your system.

Upgrade from previous version

Databases created in previous versions are fully compatible with the current version.

Windows: unzip the Windows package anywhere on your system. Replace the old exe, lib directory and README.html file with the new versions. Leave everything else untouched.

MacOS: move the old openMSX Launcher to trash. Open the downloaded DMG and drag "openMSX" into your "Applications" folder. No need to worry about previous databases because they are stored in the Users folder.

Linux/BSD: unzip the Linux/BSD package anywhere on your system.

How to start

Windows: double-click on the exe file.

MacOS: double-click on the application icon.

Linux/OpenBSD: type then enter from the command line.


1) Emulator and machines folders:


Emulator: <Path>\

Machines: <Path>\share\machines


Emulator: /Applications/

Machines: /Applications/

Linux (Debian, fedora, ubuntu):

Emulator: /usr/bin

Machines: /usr/share/openmsx/machines


Emulator: /usr/local/bin

Machines: /usr/local/share/openmsx/machines

2) Screenshots: This is the directory where game screenshots can be found. This collection of screenshots is the one used by blueMSX Launcher, and can be downloaded from:

3) Database: This is the database to display automatically when the launcher is started.

4) Language: openMSX Launcher support many languages. When the launcher is started, it will try to detect the language of the system automatically. If that fails (i.e. if it still uses English text even if your system language is different), you can force the language selection here.

Fill Database

This is a tool that scans your storage drive for MSX software supported by openMSX and adds it to launcher databases.

Right-click context menu

When right-clicking on one or more selected profiles in the game list, a context menu with two items appears and they are:

1) Move: this allows you to move the selected profiles to other databases. A confirmation dialog with many options appears in case of conflicts.

2) Locate File: this only works on a single selection and it brings up the current platform's file manager. File Explorer on Windows and Finder on MacOS will open up with the profile's main file highlighted. On Linux running GNOME, nautilus will open up with the directory where game's main file is.

To do for future versions

1) Database manager (to delete, rename and restore databases).

2) Filters.

3) Favorites.

4) Search.

5) Catapult features.

6) Import blueMSX Launcher databases.

7) Android version.

8) Many other things.

Support/Suggestions/Questions/Translation fixes

Email Sam Elsharif at oelsha at engineer dot com.

Release history

Version 1.1 - released Sep 7, 2013

Enhancements: Bug fixes:

Version 1.0 - released Jul 8, 2013