GXMame Documentation: Installation of GXMame

Next Previous Contents

## 2. Installation of GXMame

## 2.1 Requirements

### To compile it:

- libgtk+2.x.x-devel
- zlib-devel
- GNU development environment: gcc, gmake...
- I almost forgot... the source of GXMame of course

### To run it:

- libgtk+2
- zlib

## 2.2 Compilation and/or Installation

For most of systems, these instructions should allow to compile and install GXMame without problem, if any, you can read the INSTALL file include in the GXMame package.

### from the source

First of all, check that you have the latest source at http://gxmame.sourceforge.net/downloads.php

then uncompact it:

`tar xvzf gxmame-version.tar.gz`

change to that directory:

`cd gxmame-version`

run the configuration file:

`./configure`

If you're using `csh' on an old version of System V, you might need to type ``sh ./configure`' instead to prevent ``csh`' from trying to execute ``configure`' itself.

you can pass several parameters to the configure script:

- `--enable-debug` to allow printing of debug lines in the terminal and keep all symbol in the executable.
- `--enable-joystick` to enable the joystick support in the gui.

run the make file to build the program:

`make`

install the program

`make install`

You may need to be root to execute this step.

### From the source-rpm

Check that you have the latest rpm-source at http://gxmame.sourceforge.net/downloads.php

build it:

`rpm --rebuild gxmame-version.src.rpm`

install it

`rpm -Uvh /path_to_your_RPM_build_directory/your_arch/gxmame-version.your_arch.rpm`

where your arch is your computer architecture (i386/i586/k6...)

### From the rpm binary

Check that you have the latest rpm-binary at http://gxmame.sourceforge.net/downloads.php

install it

`rpm -Uvh gxmame-version.i586.rpm`

### From the debian package

Check that you have the latest debian package at http://gxmame.sourceforge.net/downloads.php

`dpkg -i gxmame-version.deb`

if you download the file from GXMame website or

`apt-get install gxmame`

if you have a sourcefile providing GXMame.

## 2.3 Installation of other files

You may want to download and install other files to enhance the visual of GXMame.

### Art Files

- snap.zip : These are a series of files that contain in-game screenshots of every game. Download the packs and either:
  - extract their contents into the `/usr/lib/games/xmame/snap/` directory.
  - put all pictures into one file named `snap.zip` and put it into the `/usr/lib/games/xmame/snap/` directory.
- titles.zip : These are a series of files that contain title screenshots of every game. Download the packs and either:
  - extract their contents into the `/usr/lib/games/xmame/title/` directory.
  - put all pictures into one file named `titles.zip` and put it into the `/usr/lib/games/xmame/titles/` directory.
- marquees.zip : These are a series of files that contain images of the signs that topped arcade machines. Download the packs and either:
  - extract their contents into the `/usr/lib/games/xmame/marquees`/ directory.
  - put all pictures into one file named `marquees.zip` and put it into the `/usr/lib/games/xmame/marquees/` directory.
- flyers.zip : These are a series of files that contain images of the original promotional material sent to arcade owners when the games came out, exhorting them to buy the games. Download the packs and either:
  - extract their contents into the `/usr/lib/games/xmame/flyers/`directory.
  - put all pictures into one file named `flyers.zip` and put it into the `/usr/lib/games/xmame/flyers/` directory.
- cabinets.zip : These are a series of files that contain images of the actual arcade machines themselves, showing what they looked like in their native habitat. Download the packs and either:
  - extract their contents into the `/usr/lib/games/xmame/cabinets/` directory.
  - put all pictures into one file named `cabinets.zip` and put it into the `/usr/lib/games/xmame/cabinets/` directory.

You can put these files into another directories but you will need to change paths from GXMame directories window.

- icons.zip : These are a series of files that contain icons for the game (you can find another serie of icon at Mamu's website). Download the packs and either:
  - extract their contents into the `/usr/lib/games/xmame/icons/` directory.
  - put all pictures into one file named `icons.zip` and put it into the `/usr/lib/games/xmame/icons/` directory.

You can put these files into another directories but you will need to change paths from GXMame directories window.

### Support Files

- history.dat : This file contains the original game's designer's names, tips / tricks and game history information which is accessible in the MAME user interface. Place this file in the `/usr/lib/games/xmame/` folder.
- mameinfo.dat : This file contains a list of MAME-specific emulation problems, which can be accessed through the MAME user interface. Place this file in the `/usr/lib/games/xmame/` folder.
- hiscore.dat: This file contains highscore saving and loading information for games that didn't actually have highscore saving and loading in the arcades. Note that this file is an externally supported database, not every candidate game is supported in it. You must use this file to get hi scores in most early games. Place this file in the `/usr/lib/games/xmame/` folder. Note you can find an unofficial highscore.dat here.
- cheat.dat: This file allows you to enable enable cheat in the games. Place this file in the `/usr/lib/games/xmame/` folder.
- catver.ini : This files allows GXMame to sort games by version and categories. Place this file in the `/usr/lib/games/xmame/` folder. GXMame support the catver file for Unix (gRCatVer) and the catver.ini for dos (CatVer). You can also find a version of catver from catver.com

You can put these files into another directories but you will need to change paths from GXMame directories window.

Next Previous Contents