qmc2-main-gui - Man Page

QMC2 — M.A.M.E. Catalog/Launcher II

Synopsis

qmc2-sdlmame [-config_path path] [-cc] [-tc] [-r] [-h|-?|-help] [qt_arguments]

QMC2 is a graphical front-end based on Qt which drives the great MAME emulator. Besides being a powerful catalog and launcher for systems emulated by MAME it also contains sophisticated ROM management features through its built-in ROMAlyzer.

Options

-config_path path: Specify this argument to use the directory path instead of the default folder (~/.qmc2) to store QMC2's configuration, logs and cache-files / cache-folders.
-cc: This command line option will instruct QMC2 to clear all emulator related caches while starting up in order to forcibly reload this data from the emulator.
-tc: Specifying this option on the command line will perform a template check against the current default emulator (if set), printing its output to stdout and exiting before actual start-up occurs.
-r: The reconfigure option will relaunch the setup wizard / welcome dialog before starting. This allows you to update or correct the most important emulator settings in an easy way.
-h|-?|-help: Shows a brief command line usage help.
qt_arguments: See https://doc.qt.io/qt-5/qapplication.html#QApplication for more information. However, note that QMC2 will overwrite most of the available Qt arguments with its saved settings in ~/.qmc2/qmc2.ini.

Files

/etc/qmc2/qmc2.ini: System-wide default configuration (optional)
~/.qmc2/qmc2.ini: Individual user's configuration (system-wide settings will be copied initially, if any)
~/.qmc2/qmc2-sdlmame.log: Front-end log from the last run of QMC2
~/.qmc2/mame.log: Emulator-log containing the output from emulator instances launched by QMC2 (cleared whenever the 'first' emulator instance is launched)
~/.qmc2/mame.rsc: ROM state cache
~/.qmc2/mame.mlc: Machine list cache
~/.qmc2/mame.mlc.filtered: Filtered version of the machine list cache used by qmc2-arcade(6) (optional)
~/.qmc2/mame-xml-cache.db: XML cache database (SQLite 3)
~/.qmc2/mame-user-data.db: User data database (SQLite 3) containing rank information and personal comments per machine as well as paths to system- and software-manuals per machine/software
~/.qmc2/mame-machine-list.db: SQLite3 database version of the machine list cache (used by custom views)
~/.qmc2/mame-swl-cache.db: Software-list XML cache database (SQLite 3)
~/.qmc2/mame-icon-cache.db: Icon cache database (SQLite 3)
~/.qmc2/mame-dat-info.db: DAT-info database (SQLite 3), a combined data store for all supported DAT-info sources (emu-info, machine-info and software-info)
~/.qmc2/mame.fav: List of favorite machines
~/.qmc2/mame.hst: List of machines last played (play history)
~/.qmc2/mame.sic: Slot-info cache
~/.qmc2/sw-state-cache/*.ssc: Software-state cache
~/.qmc2/youtube/qmc2-sdlmame.yti, ~/.qmc2/youtube/*.png: YouTube video info/image cache
~/.qmc2/LocalStorage/*.localstorage: Folder used by the built-in web-browser to create small database files for 'HTML5 localStorage' support
~/.qmc2/qmc2-sdlmame-cookies.db: Permanent web-page cookie database (SQLite 3)
~/.qmc2/qmc2-sdlmame-checksum.db: ROMAlyzer's system-mode check-sum database for storing/retrieving paths to dumps available in your file-system by SHA-1 and/or CRC-32 (SQLite 3)
~/.qmc2/qmc2-sdlmame-software-checksum.db: ROMAlyzer's software-mode check-sum database for storing/retrieving paths to dumps available in your file-system by SHA-1 and/or CRC-32 (SQLite 3)
~/.qmc2/WebpageIcons.db: Web-page icon database (SQLite 3)