\input texinfo @c
@setfilename INSTALL.win32.info
@settitle INSTALL.win32
@node Top, , , (dir)

@chapter 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 
@file{solfege-win32-x.y.z.zip} instead of the @file{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 @uref{http://www.python.org/2.0.1}. 

You also need:
@itemize @bullet
@item http://hans.breuer.org/dia/gtk+-bin-2000-08-26.zip
@item http://hans.breuer.org/ports/pygtk-2000-11-26.zip
@item http://download.sourceforge.net/solfege/solfege-win32-x.y.z.zip
@end itemize

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 @file{solfege.bat} file.
Notice that you probably must edit @file{solfege.bat} and set the
@env{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.

@section 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
@file{midiplayer.exe} is still possible, but talking directly
to the soundcard is now the default. (@file{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 @file{midiplayer.exe} works and
winsynth fails.

@section Trouble?
Try to delete the file @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.
