qmc2 / qmc2-mame-fe

QMC2 - M.A.M.E. Catalog / Launcher II
40 stars 3 forks source link

What is the M.A.M.E. Catalog / Launcher II?

M.A.M.E. Catalog / Launcher II - also referred to as QMC2 - is the successor of one of the first UNIX M.A.M.E. GUI front ends available on this planet called QMamecat (derived from MAMECAT, which was text-only). QMamecat was based upon Qt 2; its development was frozen in 2003.

By the beginning of March 2006, we started to build QMC2 from scratch as a Qt 4 project. Parts of the design and code were inspired by its predecessor, but it's not just a remake. We tried to make the new design as flexible as possible to minimize dependencies from front end and CLI related MAME changes, which was a major deficiency of QMamecat. QMC2 now uses a template based emulator config scheme, which can easily be enhanced with additional command line options (defined in an XML template file).

As a result of this flexible design and countless hours of work, QMC2 today is not only a stable, feature-rich and fast multi-platform GUI front-end for M.A.M.E. but also a fully-featured ROM manager for this emulator (and its derivatives, older versions of MAME or even foreign emulators when they use the same/similar XML data) through the built-in ROMAlyzer.

Today, only Qt 5.4+ is supported. Note that for the full functionality of QMC2 Qt 5.11+ is required (Qt 5.15 is recommended)! Qt 6 isn't supported yet.

Building and installing QMC2 from source

It's as simple as this:

$ make [-j ] ...

Followed by

$ sudo make install ...

This builds the main GUI - actually all you'd need. But if you want to build and install qmc2-arcade (additionally) or qchdman (works stand-alone), you'd need to run (either of) the following:

$ make [-j ] arcade $ sudo make arcade-install

$ make [-j ] qchdman $ sudo make qchdman-install

Run

$ make help

to see the full list of build targets and

$ make config

to get a help on configuration variables that you'd want to change. However, most of the time the defaults are okay.

License

Copyright (C) 2006 - 2022 rene.reucher@batcom-it.net

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Author

René Reucher (rene.reucher@batcom-it.net)