qmc2-arcade - Man Page

Arcade / non-desktop version of QMC2 ā€” M.A.M.E. Catalog/Launcher II


qmc2-arcade [-theme qml_theme] [-console type] [-language lang] [-video vdo] [-config_path path] [-fullscreen] [-windowed] [-nojoy] [-joy index] [-debugjoy] [-debugkeys] [-debugqt] [-h|-?|-help]


For those who want to 'go straight into the games' there's QMC2 Arcade, a QML / QtQuick based approach to presenting an optionally filtered machine-list, launching emulators in the same smart way that you're used to with QMC2's main GUI (see qmc2(6)).

Although it's designed to run stand-alone, you must start QMC2's main GUI at least once prior to using QMC2 Arcade, because some of the file caches need to be created first - QMC2 Arcade doesn't take care of this itself. Also, you cannot change the emulator's configuration from within QMC2 Arcade. So whenever you want to make modifications to a machine's configuration (or the global setup) you have to do this through QMC2's main GUI as well.

The main GUI also has a specific dialog for setting up all relevant back-end default options (-theme, -console, -graphicssystem, -language and -video), for producing a filtered machine list used by QMC2 Arcade exclusively (optional) and for mapping key-sequences or joystick-functions (also optional). Default values for back-end options can also be configured inside QMC2 Arcade provided the chosen qml_theme supports it (which all of the available themes do).

Changed back-end default options will require a restart of QMC2 Arcade to take effect. Specifying them on the command line will overwrite the current defaults temporarily, but will not change their stored default values. Note that the -language back-end default option is a shared setting for both QMC2 Arcade and the main GUI.


-theme qml_theme

Select the QML theme used for scene graphics, animations and/or shader effects. Available values for qml_theme are 'ToxicWaste' (default) and 'darkone'.

-console type

Choose the type of console to use. Available values for type are 'terminal' (default), 'window', 'window-minimized' and 'none'. Console type 'none' will effectively suppress all log messages.

-language lang

Choose translation to load. Run 'qmc2-arcade -h' for a list of available values for lang. Note that the default value for -language is shared with the main GUI's language setting!

-video vdo

Enable (vdo = 'on') or disable (vdo = 'off') the use of video snaps (theme-specific). The value of vdo will be ignored when the current theme has no built-in support for video snaps.

-config_path path

Specify this argument to use the directory path instead of the default folder (~/.qmc2) to search for QMC2's configuration and cache-files.


Start up in full screen mode, overwriting the stored setting


Start up in windowed mode, overwriting the stored setting


Disable joystick-function mapping (regardless if it's enabled in the main GUI or not).

-joy index

Use the joystick specified by index instead of the one read from ~/.qmc2/qmc2.ini, and enable joystick-function mapping (regardless if it's enabled in the main GUI or not).


Enable debug logging for joystick-function mapping. Every recognized joystick-function which has been mapped to a key-sequence will be logged to the console.


Enable debug logging for key-sequence mapping. Every recognized key or key-sequence will be logged to the console together with info on how the event is processed. Mapped key-sequences will cause event emulation, others will follow Qt's default event processing.


Enable logging of Qt debug messages


Show usage help, available options / values and their current defaults.



System-wide default configuration (optional)


Individual user's configuration


Machine list cache


Filtered version of the machine list cache created by qmc2(6) (optional)


Icon cache database (SQLite 3)


DAT-info database (SQLite 3), a combined data store for all supported DAT-info sources (emu-info, machine-info and software-info)

See Also

qmc2-sdlmame(6), qchdman(6)


See the TODO file in the included QMC2 documentation for known bugs and restrictions.

New bugs can be reported here: https://tracker.batcom-it.net/view_all_bug_page.php?project_id=1


The QMC2 development-team (https://qmc2.batcom-it.net/)

Referenced By

qchdman(6), qmc2-main-gui(6).

July 23, 2022 0.243 QMC2 User's Guide