qmc2-main-gui man page

qmc2-sdlmame — QMC2 — M.A.M.E. Catalog/Launcher II

Synopsis

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

Description

QMC2 is a graphical front-end based on Qt which drives the great MAME emulator. Besides being a powerful catalog and launcher for MAME systems 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 (remove) all emulator related cache files 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 exit before actual start-up occurs.

-r

The reconfigure option will rerun 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 http://doc.qt.io/qt-4.8/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)

See Also

qmc2-arcade(6), qchdman(6)

Bugs

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

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

Author

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

Referenced By

qchdman(6), qmc2-arcade(6).

February 22, 2017 0.183 QMC2 User's Guide