-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
168 lines (117 loc) · 6.15 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
GNOME Video Arcade
==================
Written by Matthew Barnes <[email protected]>
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 <[email protected]>