PANDA-glGo Installation ----------------------- Windows ------- For Windows there is a common installer. Double-click on the downloaded glGo-xxx.exe file and follow the instructions. You need OpenGL libraries installed, they are included in the standard installation of Windows 98 and newer (not recommended) or come with your hardware driver. See section Requirements in the Readme file or the manual for details. Summarized, install a suitable driver for your graphiccard which is distributed by the cards vendor. Do not use the Microsoft driver. The glGo installer includes the redistributable OpenAL library published by Creative (http://developer.creative.com/). The installer includes the required SDL and Python runtime libaries. If you want to play with GNU Go, get one of the many Windows GNU Go binaries and drop gnugo.exe into the glGo installation folder. You can download a ready-to-run GNU Go for Windows from the glGo webpage or from many other sites on the Internet. If you are running Windows 98 and have trouble with text scrolling in the IGS textareas, replace C:\Program Files\glGo\share\resource.xrs with resource.xrs_win98 found in the same directory. Also try changing the setting for "Force scrolling" in the preferences, see IGS tab. Linux ----- Install the .rpm or .deb files like you would install any of these packages: "rpm -i glGo-xxx.rpm" or "dpkg -i glGo-xxx.deb". If you use the .tar.gz archive, unpack it somewhere and run the glGo.install script. To uninstall, run glGo.remove. Basically it does not matter which of the installers you use. Take the one most fitting for your distribution. They all install exactly the same files. The user configuration is found in $HOME/.glGo. Please remove this directory manually after uninstalling. In any case you require OpenGL libraries installed, but they are installed together with your hardware driver. In worst case, install the Mesa libraries for software-only rendering, but this is not recommended glGo on Linux uses the GTK-2 toolkit. This requires a couple of libraries available. They should be installed together with GTK-2 from your distribution. If you use the Gnome desktop, you already have all of these libraries. You need the following SDL libraries: libsdl, libsdl_ttf and libsdl_image. They are available with all major Linux distributions. If you don't have them already installed, get them from your distribution. In case try "ldd glGo" to check the dependencies. You need the Python 2.4 runtime library installed (shared library). Python should be included in almost every Linux distribution. For the sound system you need either the OpenAL or the SDL_mixer runtime libraries installed. They should be included in every Linux distribution. Unlike Windows, OpenAL is not included in the Linux glGo installer, as it is to be preferred to use your Linux distribution version. If neither libopenal nor libSDL_mixer are available, glGo should still run, but without sound output. Here are the most importantant dependencies. Nothing special, but you might need to install some library from your distribution. * libgtk 2.0 * libjpeg * libpng 1.2 * libz * libGL * libGLU * libSDL 1.2 * libSDL_image 1.2 * libSDL_ttf 2.0 * libfreetype * libpython 2.4 * libpango 1.0 * libfontconfig Optional for sound output: * libopenal * libSDL_mixer If you want to play with GNU Go, please install it from your distribution, it is included in almost any, or compile it yourself. Make sure the gnugo binary is found in your PATH environment, so glGo will find it. Common locations are /usr/local/bin, /usr/bin or /usr/games/bin. If you installed glGo in an unusual directory, you can use the "-s" commandline option to point to the shared data directory. Example: glGo -s /home/foobar/myprogs/coolapps/glGo/share. Another possibility is to set the environment variable GLGO_SHARED_PATH, for example in bash: export GLGO_SHARED_PATH=/home/foobar/myprogs/coolapps/glGo/share The "-s" option has higher priority than the environment variable. If neither is given glGo will search for the shared directory in the folder the binary is located, /usr/share/games, /usr, /usr/local, /usr/local/share/games, /opt, $HOME, $HOME/glGo and $HOME/.local/share/glGo. If no shared directory is found, glGo will fail to start. If you keep the default directories in the installation and don't move files around later, you do not need to worry about this. glGo support libraries (libalsound.so, libsdlsound.so and libsgfparser.so) are located in /usr/lib/games/glGo. If you really need to move this directory around, you need to tell glGo the location of these libraries. You can do this by setting the environment LD_LIBRARY_PATH to the new directory. Macintosh --------- glGo requires Mac OS X 10.3 "Panther". It does not run on OS X 10.2 and earlier. To install glGo, mount the disk image you downloaded in Finder and copy the glGo icon to your Applications folder. If you also want the Playermanager, copy the Playermanager icon to your Applications folder as well. The Playermanager is optional and not required to run glGo. That's it! To uninstall glGo move the glGo and Playermanager icons from the Applications folder into the Trash. You can manually delete the directory /Users/yourname/.glGo to delete the glGo configuration. If you want to play with GNU Go, you can download a ready-to-run GNU Go for Macintosh from the glGo webpage.