**********
* GXMame *
**********

For more informations, consult the HTML documentation or the website.
http://gxmame.sourceforge.net/docs.php

ABOUT
-----

GXMame is a frontend for XMame using the GTK library, the goal is to provide 
the same GUI than mame32.
For the moment it will just have the same gui, the final goal is to be able 
to share config files with Mame32k (or any version of mame32 that write config 
files instead of saving data into windows registery) to allow dual booter to 
have the same environement (favorite, timeplayed, last game selected, gui 
preference...) under windows and Linux.

FEATURES
--------

- Create a game list from your xmame executable and displayed it in a small 
  icons view, detailled view or indented view.
- Allows to have a basic filtering via the folder panel (only neo-geo or 
  working or available [or...] games). 
- Display a snapshot of the current selected game in the screeshot panel, you 
  need to specify the path to snapshots in Option->directories. Uncompressed 
  and zipped snapshots are supported.
- You can change snapshot type by clicking on the snapshot picture. GXMame will
  display successively Ingame, Flyers, Cabinet, Marquees and Titles. 
- A status bar allow to see the title of the game, its status and the number of 
  games dislayed in the current view.
- A toolbar allow to quickly change the configuration of the gui
- You can hide toolbar, status bar, folder panel and screenshot panel by the 
  menu.
- Random game selection.
- Support of catver to sort games by version and categories.
  (you need catver available at http://www.mameworld.net/catlist/)
- General and specific game options.
- Audit of all games or a specific one.
- Joystick support to select games.
- Multiple executables support.
- Record and playback games.
- multilingual.


BUILD
-----

Just read the 'INSTALL' file for more detailed directions.

you can pass several parameters to the configure script:
 --enable-debug         prints debug line in the terminal and keep all
                        symbols in the executable.
 --disable-joystick     disables the joystick support in the gui.

You need to have the development packages GTK+ 2.0 or higher and zlib.

If you want to run autogen.sh you will also need automake 1.7 and
autoconf 2.53 or higher.

RUN
---

To run it just type gxmame from a terminal, you can also run it from an your 
menu but you will have more information displayed in the terminal, don't forget 
that it's a beta version, the final version will have everything in the 
graphic window.

CONFIG
------

GXMame is completely configurable from the GUI, all config files are stored in 
your '$HOME/.gxmame/' directory, games options are in '$HOME/.gxmame/options':
default is preferences for all games and each game with different preferences 
will have a file named 'romname' if you want to reset a game preferences, just 
remove the preferences file for this game, to reset all preferences to default,
just remove the 'default' file.
Files are:
gamelist:	This is the gamelist automatically generated by GXMame at the 
		begining, you won't normaly have to edit this one
games.ini:	Some information for each game, it is also automaticaly 
		generated by GXMame and the only reason I see to edit this file
		is to reset the number of time you played with a game.
gxmame.ini:	Contain gxmame preferences(compatible with mame32k), every parameter here are 
		saved when GXMame ends and reload when GXMame starts.
gxmamerc:	Contain other gxmame preferences, every parameter here are 
		saved when GXMame ends and reload when GXMame starts.
dirs.ini:	This one contain path to different locations:
		roms and samples path, Snapshot directory...

FILES:
------
you can use various files to display info and pictures of games.
http://www.mameworld.net/catlist/
You can download here the catver.ini file that allows GXMame sort games by version and categories
	
http://www.classicgaming.com/mame32qa/
the mame32 qa/test & art dept.
You'll find here screenshots, flyers, cabinets, titles, icons and backgound for your front-ends.

http://www.mameworld.net/icons/
Mamu - another website where you can find icons.

http://www.eldio.co.uk/emam/
EMAM
You'll find here marquees for your front-ends.

http://fandemame.emu-france.com/
Fan de mame
fanbuild and history.dat file

http://www.mameworld.net/mameinfo/
MASH's MAMEINFO
Mameinfo.dat

http://cheat.retrogames.com/
Pugsy's MAME Cheat Page
cheat file for mame

http://www.mame.net/hiscore.html
official hiscore.dat file for mame

http://www.mameworld.net/highscore/
unofficial hiscore.dat file for mame

