These steps are needed to compile and run what you download from the
Gnome CVS tree:
1) Install needed libraries. Essentially, you need gnome-libs, gtk+, glib,
imlib, and all the other normal Gnome stuff. For now, just get the
latest and greatest, since we are tracking Gnome pretty closely.
2.a) To compile Gnomehack from a source tarball, uncompress the tarball, and
in the gnomehack-1.0.x directory, type "./configure" If it complains
about missing stuff, go get and install the stuff it complains about.
When you get the "./configure" script to finish setting things up, you
will simply want to type "make" to compile everything.
2.b) To build Gnomehack from CVS, go to the nethack directory, and type
"./autogen.sh" This will run the configure script. If it complains about
missing stuff, go get and install the stuff it complains about. When
you get the "./autogen.sh" script to finish setting things up, you will
simply want to type "make" to compile everything.
3) Install Gnomehack. Basically (as root) you will want to do the following:
4) Read doc/Guidebook to learn about nethack (if you have never played
before). You might want to visit the Official nethack web page at
and you might want to visit the GnomeHack web page at:
One common thing you might want to do is set up a ~/.nethackrc
file. This will allow you to select between the text and the Gnome user
interfaces (both interfaces should have been compiled into the nethack
binary). I have the following in mine:
5) If you want to play the console version (which should also be compiled in
by default, just change your .nethackrc file to comment out the
"windowtype:Gnome" stuff, and uncomment the "windowtype:tty" line.
6) Type "nethack" and enjoy!
If you have any problems, suggestions, or even better -- working
patches, please send email to the gnomehack mailing list at
List subscription info can be found on the GnomeHack web page at
If you have bugs to report, please use the GNOME Bug Tracker
Have fun, and happy nethacking!