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

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 or detailled 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 snapshot into dirs.ini. Only 
uncompressed snapshot in PNG format are supported now.
- 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/)
For all the xmame preferences, you need to edit your xmame config file by hand.


BUILD
-----

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

you need to have GTK at least 1.2 (I haven't tried GTK2 but I don't think 
it will cause any problems)), you also need to have gdk-pixbuf.


RUN
---

to run it just type gxmame from a terminal, you can also run it from an icon
(as soon as I think to put it) but you will have more information displayed in
the terminal, don't forget that it's an alpha version, the final version will 
have everything in the graphic window.
you also need to have xmame in your path

CONFIG
------

You can configure GXMame by editing files in '$HOME/.gxmame/' but it's preferable 
to do everything from the option -> directories menu
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, 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...

For all the xmame preferences, you need to edit your xmame config file by hand.

