openMSX Launcher v1.4
openMSX Launcher is a front-end for openMSX written in Java, and runs 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 Launcher.app" into your "Applications" directory.
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,
extra-data.dat and README.html files with the new versions. Leave everything else untouched.
MacOS: move the old openMSX Launcher to trash. Open the downloaded DMG and drag "openMSX
Launcher.app" into your "Applications" directory. No need to worry about previous databases because they are stored
in the Users directory.
Linux/BSD: unzip the Linux/BSD package anywhere on your system. Replace the old openmsx-launcher.run, lib
directory, extra-data.dat and README.html files with the new versions. No need to worry about previous databases because they are
stored in the current users's home directory.
Starting from versions later than 1.4, upgrades can be done inline from within the launcher. The availablility of a new version
of the launcher, extra data and screenshots can be checked from the Help menu and the new version of the launcher and extra data
can then be downloaded directly. All you need to do after downloading the new launcher is to restart it.
How to start
Windows: double-click on the exe file.
MacOS: double-click on the application icon.
Linux/OpenBSD: type and enter openmsx-launcher.run in a terminal window. In a GNOME environment you can a
shortcut to the launcher
1) Emulator and machines directories:
Note: the detect button will 'suggest' the path to the openMSX based on the platform. Try that first, and if that doesn't
work you can enter it manually.
Linux (Debian, fedora, ubuntu):
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: http://msxlaunchers.info.
3) Database: This is the database to display automatically when the launcher is started.
4) Language: openMSX Launcher supports 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.
This is a tool that scans your storage drive for MSX software supported by openMSX and adds it to the launcher databases.
Favorites button is located above the four main buttons. When pressing it, a menu containing the currently saved favorites appears.
You can go straight to your favorite game by selecting one from the list. You can also delete the favorite there as well.
Filters button can be found under the game list. When pressing it, a menu pops up with a list of saves filters,
small buttons to either delete or edit saved filters and options to reset current filters and add new ones.
Update All Databases
This is a tool that updates extra data for games in all databases (including update display of screenshots) when there's
a new version of the extra-data.dat file and screenshots. It will also fix a bug that existed in versions
1.0 and 1.1 where some fields were not set correctly when using the 'Fill database' feature.
Right-click context menu
When right-clicking on one or more selected profiles in the game list, a context menu with three items appears and
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.
3) Add to Favorites: add the selected game to the list of favorites. The list is accessible through the favorites button
in the main window.
4) Info: this displays the user-specified info file using the system's default viewer. In the "Fill Database" feature, this
field gets set to the game's MSX Generation page, but it can be anything the user desires (text file, PDF, etc).
5) Properties: this only works on a single selection and it brings up the properties screen for the selected game.
This can be accessed from the Tools menu. There you can rename or delete existing databases.
Note: currently there's no support for viewing or restoring backups.
|Windows / Linux / BSD||Mac||Action|
|Del||Del||Remove profile button|
|Insert||Insert||Add profile button|
|Ctrl+E||Command+E||Add profile button|
|Ctrl+D||Command+D||Add to Favorites|
To do in future versions
1) Add support for backups in the Database Manager.
2) Android version (I developed a prototype but openMSX on Android doesn't accept arguments when started from a different App therefore I stopped).
3) Catapult features.
5) User-defined fields.
Support/Suggestions/Questions/Translation fixes/New translations
Email Sam Elsharif at oelsha at engineer dot com.
Version 1.4 - released Feb 7, 2015
- Added favorites support
- Added ability to check for updates from within the launcher and the ability to update automatically
- Made changes to main window
- Allow only one instance of the launcher to run
- The extensions list in the Add/Edit profile was not showing the extensions for the latest versions of openMSX
after the switch from directories to XML files. This should work now for all versions of openMSX. There is similar to the machines
listing bug that was fixed in the previous version of the launcher
Version 1.3 - released July 6, 2014
- Switched to an embedded database (Apache Derby) from CSV files to store launcher data. All user's CSV files are migrated to the new embedded database automatically when new launcher is started for the first time
- Old backups are deleted. The new version allows to take backups but they still cannot be restored
- Switched to JDK 7. Now Java Runtime Environment 7 or higher is needed to run the launcher
- Added Database Manager to rename or delete databases
- Simplified the settings window by removing the machines field and adding a button to detect the openMSX path (Note: Mac users
need to set the openMSX path value to /Applications or the directory where the launcher is installed)
- The update all databases tool now returns the number of updated profiles
- Added keyboard short-cuts
- Added a tool to import blueMSX Launcher databases (only for the Windows version)
- Added total known dumps to the profile properties window
Version 1.2 - released May 4, 2014
- The machines list in the Add/Edit profile and Fill Database screens was not showing the machines for the latest versions of openMSX
after the switch from directories to XML files. This should work now for all versions of openMSX
- Added ability to filter databases by company, year, country, medium, size, MSX generation, sound chip and genre
- Added game properties in the right-click contect menu
- Added ability to update game extra data in all databases. Useful when there's a new version of the accompanying extra-data.dat file
- Added slight display improvements to the Mac version
- Added ability to select a game in the list by typing the first few letters of its name
Version 1.1 - released Sep 7, 2013
- Some fields set internally in the game profile (and only now displayable in the new properties screen) were not correct.
The new 'Update all databases' feature fixes that automatically
- Added ability to move games between databases via the right-click context menu
- Added ability to bring up the platform's file manager (File Explorer on Windows, Finder on MacOS, etc) via the
right-click context menu
- Added menu item in the Help menu to bring up the help file
- Added ability to create empty databases
- Added a bar above the game list to show company, year and size of file of the selected game
- File fields in Add/Edit screens now support drag and drop of files
- If a script is defined in the profile then it will override all other fields when openMSX is launched
- Many other minor enhancements
Version 1.0 - released Jul 8, 2013
- When adding a new game or editing a new one, the recorded size for ZIP files, which is stored in the database,
is wrong. This will be seen with this new version where the size displayed in the bar above the game list will be
that of the ZIP file rather than the original size. In order to fix it, just edit the game and save immediately
without modifying any other fields
- Create multiple databases of all MSX software supported by openMSX
- Scan the hard disk to automatically fill launcher databases with ROMs, disks, tapes, hard disks and laserdiscs,
and sync the database to your hard disk any time later.
Display two screenshots for each game
- Display the text on the launcher using a number of supported languages (English, Arabic, Catalan, Chinese
Simplified, Chinese Traditional, Dutch, Finnish, French, German, Italian, Japanese, Korean, Persian, Portuguese,
Russian, Spanish and Swedish)