INSTALL.win32 - how to install GNU Solfege on MS Windows
********************************************************

   Windows users usually don't have all the tools required to build the
documentation (m4 and texinfo) and the midi module (C compiler), so to
save you the trouble, you can download `solfege-win32-x.y.z.zip'
instead of the `solfege-x.y.z.tar.gz' file that only contains the
source code.

   You must install python 2.0.1 before you continue.  More info on
`http://www.python.org/2.0.1'.

   You also need:
   * http://hans.breuer.org/dia/gtk+-bin-2000-08-26.zip

   * http://hans.breuer.org/ports/pygtk-2000-11-26.zip

   * http://download.sourceforge.net/solfege/solfege-win32-x.y.z.zip

   Newer or older versions of gtk and pygtk might work, but don't come
screaming for help if they break. (But please do if the above urls
disappear.)  If you have gimp installed, you can probably drop
gtk+-bin-2000-08-26.zip. But I am not sure, since I don't want to
download gimp for ms-windows just to test this.

   The two first zip-files should be installed into a folder named
pygtk, for example c:\pygtk or c:\programfiles\pygtk.

   Then unzip solfege-win32-x.y.z into the same folder as the pygtk
folder was created.

   Depending on where you unzipped your files, you will have a
directory tree looking something like this:

\Program files\pygtk\lots\of\files
\Program files\solfege-x.y.z
\Program files\solfege-x.y.z\README
\Program files\solfege-x.y.z\solfege.py

   Notice that the 'pygtk' and 'solfege-x.y.z' folders has to be in the
same folder, installing like this will fail:

\pygtk
\Program files\solfege-x.y.z

   You start the program by executing the `solfege.bat' file.  Notice
that you probably must edit `solfege.bat' and set the `PATH' variable
to point to where you have the python interpreter installed.

   Sometimes windows can have trouble finding/loading some of the
gtk.dll's, it usually works if you try to start the program a few times
more.

Sound
=====

   The first port to MS Windows had to call an external midiplayer
program to play the music, but thanks to Joe Lee, Solfege now talks
directly to the soundcard, just like on linux. Using `midiplayer.exe'
is still possible, but talking directly to the soundcard is now the
default. (`midiplayer.exe' will disappear in a later version if nobody
needs it.)

   Please let me know if you have any problems with this new sound
code, and especially if using `midiplayer.exe' works and winsynth fails.

Trouble?
========

   Try to delete the file `\home\solfegercX.Y'. You can also see the
files FAQ, INSTALL and README. If you still are stuck, you can email
solfege-devel@lists.sourceforge.net and ask for help.  Tell what
version of Solfege you are running, the version and name of the
operation system and what your problem is.

