GNOME Video Arcade
==================

Written by Matthew Barnes <mbarnes@redhat.com>

GNOME Video Arcade is a clean and simple MAME front-end for any
freedesktop.org compliant desktop environment.

This project is targeted towards non-technical arcade enthusiasts
who just want to easily play classic arcade games on their desktop.
Though it may be suitable for use in custom arcade cabinets, the
project is not designed for that purpose.

Webpage: http://live.gnome.org/GnomeVideoArcade

Dependencies
------------

GNOME Video Arcade has a few external dependencies which need to be
installed prior to compiling the source code:

   - mame

       This may be available as a pre-compiled package from your
       GNU/Linux distribution.  If not, you can download and compile
       the source code yourself at https://github.com/mamedev/mame.

   - intltool

       GNOME Video Arcade uses intltool to help internationalize the
       user interface.  This should be available from your GNU/Linux
       distribution as a pre-compiled package.

   - yelp-tools

       GNOME Video Arcade uses yelp-tools to build the user
       documentation.  This should be available from your GNU/Linux
       distribution as a pre-compiled package.

   - Header files for GTK+ version 3.0 (or higher).

       The GTK+ header files should be available from your GNU/Linux
       distribution as a "development" package.  The exact package name
       varies by distribution, but it should be something similar to
       gtk3-devel (Fedora) or libgtk-3-dev (Debian/Ubuntu).

   - Header files for SQLite version 3.x.

       GNOME Video Arcade uses SQLite to store detailed information
       about games supported by MAME.  The SQLite header files should
       be available from your GNU/Linux distribution as a "development"
       package.  The exact package name varies by distribution, but it
       should be something similar to sqlite-devel (Fedora) or
       libsqlite3-dev (Debian/Ubuntu).

   - Header files for libsoup version 2.4 (or higher).

       GNOME Video Arcade uses libsoup to download arcade-related images
       off the web for use in the Properties window. The libsoup header
       files should be available from your GNU/Linux distribution as a
       "development" package. The exact package name varies by
       distribution, but it should be something similar to libsoup-devel
       (Fedora) or libsoup2.4-dev (Debian/Ubuntu).

   - Header files for libwnck version 2.91.6 (or higher). (optional)

       The libwnck header files should be available from your GNU/Linux
       distribution as a "development" package.  The exact package name
       varies by distribution, but it should be something similar to
       libwnck-devel (Fedora) or libwnck-3-dev (Debian/Ubuntu).

       GNOME Video Arcade uses libwnck to implement "spatial" MAME
       windows, whereby the size and position of each game window is
       remembered across sessions.  If you prefer not to use libwnck,
       you can configure GNOME Video Arcade to not link against it.
       See the Installation section to find out how.

   - catver.ini (optional)

       This file, available from http://www.progettoemma.net/?catlist,
       contains category information for games supported by MAME.  GNOME
       Video Arcade can utilize this information in the game list.

   - history.dat (optional)

       This file, available from http://www.arcade-history.com,
       contains historical information as well as tips and tricks
       for many arcade games.  GNOME Video Arcade can utilize this
       information in its Properties window.

   - nplayers.ini (optional)

       This file, available from http://nplayers.arcadebelgium.be,
       contains more detailed information about the maximum number of
       players a game supports, including whether players alternate
       or play simultaneously.  GNOME Video Arcade can utilize this
       information in the Players column of the game list.


Installation
------------

The INSTALL file has some generic but detailed installation
instructions that are applicable to most Free Software packages,
including GNOME Video Arcade.  This section supplements the INSTALL
file with information specific to GNOME Video Arcade.

These instructions are written specifically for GNOME Video Arcade
version 0.8.5 and may change in forthcoming releases.

The standard installation procedure looks like this:

   $ cd /path/to/gnome-video-arcade-0.8.5
   $ ./configure
   $ make
   $ su -c "make install"
   (Prompted for root password)

   To start: Applications -> Games -> Video Arcade

If the configure script cannot find the MAME program, you can
specify the MAME program location by defining an environment
variable, like this:

   $ MAME=/path/to/program/mame ./configure

You can use the --with-category-file configure option to specify
the location of a catver.ini file as mentioned above.  Usage looks
something like this:

   $ ./configure --with-category-file=/path/to/catver.ini

You can use the --with-history-file configure option to specify
the location of a history.dat file as mentioned above.  Usage
looks something like this:

   $ ./configure --with-history-file=/path/to/history.dat

You can use the --with-nplayers-file configure option to specify
the location of a nplayers.ini file as mentioned above.  Usage
looks something like this:

   $ ./configure --with-nplayers-file=/path/to/nplayers.ini

The --enable-gtk-doc configure option tells "make" to generate
developer documentation while building GNOME Video Arcade.  Once
installed, the documentation can be viewed through Devhelp.

Several "with"/"without" options are available for optional libraries
including D-Bus and libwnck.  See the previous section for details on
what these libraries are used for.

For a complete list of configure options, run:

   $ ./configure --help

Usage
-----

GNOME Video Arcade comes with a user manual that describes basic usage
of the application.  You can view it by choosing Help->Contents from
the main menu in GNOME Video Arcade, or by starting Yelp and searching
for "GNOME Video Arcade".

Please feel free to email me with any questions, bugs, or suggestions.


                              - Matthew Barnes <mbarnes@redhat.com>