TiMidity++ 2.10.4 for OS/2 - ALT release 1 (2009-08-08)


  This is an updated port of TiMidity++ 2.10.4 (standalone client) for
  OS/2.  It is based on Darwin O'Conner's original port, with the
  following changes:

  - Fixed problem finding default configuration file.  The program now
    looks for TIMIDITY.CFG in the same directory as the executable.  If
    this file doesn't exist, then either %HOME%\.timidity.cfg (note
    leading dot) must exist, or else you must specify a different
    configuration file using the -c parameter.

  - Built with a later version of ncurses (v5.5).

  - Turned off debug symbols for released binary.

  Darwin's original README.OS2 is appended at the bottom of this file.
  The information therein still applies to this release, except for the
  note about having trouble finding the configuration file (which, as
  mentioned, should now be fixed).

  See the main README file, as well as the FAQ, for general information
  about using TiMidity++.


Installing

  Make sure that timidity.exe and timidity.cfg are in the same
  directory.  Edit timidity.cfg and change the 'dir' statements to
  wherever you keep your patch and secondary configuration files.
  (If you have installed TiMidity++ using my WarpIN packages, this
  should be all done for you automatically.)

  You MUST have some audio sample files installed.  See the FAQ file
  (located under 'docs') for more information.  Both GUS patches and
  SoundFonts are supported.  I highly recommend using Eric Welsh's
  EAWPATS collection.  (Alternatively, many Creative sound cards come
  with high-quality SoundFonts on the accompanying driver CD.)

  To install new GUS patches or SoundFonts, copy them to some directory
  or other.  Next, edit TIMIDITY.CFG and then make sure that directory 
  is defined (using the 'dir' parameter).  Then add the necessary 
  parameters to load them.  For GUS patches, the syntax is:
       source <config_file>
  where <config_file> (minus the angle brackets) is the name of the 
  configuration file that came with the patch set.  For SoundFonts, use:
       soundfont <soundfont_file>
  where <soundfont_file> (again, minus the brackets) is the name of the
  SoundFont file (usually with an extension like .SF2 or .SBK).


Running

  To play a MIDI (or other supported) file, run:

    timidity.exe [options] file(s)

  This assumes that you have satisfactory patch sets and/or soundfonts
  installed, of course.

  Run 'timidity -h' (or see the README) for a full list of supported
  options.

  By default, timidity.exe uses the dumb console user interface.  If you
  have the TERMINFO database installed, and a compatible SET TERM
  environment variable, then you can use the much nicer ncurses
  interface by specifying the '-in' option.

  (The ncurses interface does require TERMINFO rather than the older
  TERMCAP; a TERMINFO database is available in the ncurses library
  package, as well as from a few other sources.)


Building

  See the file COMPILE.OS2 inside src_diffs.zip.


Alex Taylor (August 2009)
alex at altsan dot org


-----------------------------------------
ORIGINAL README.OS2 FROM DARWIN O'CONNOR:
-----------------------------------------


TiMidity 2.10.4 for OS/2 readme

    Generally things work pretty much the why it says in the main
README file.

    This version support midi files as well as Module files, including
.s3m and .xm It can automatically extract file from zip and other
compression formats. It also can download files directly from the
Internet by entering a url. The the main README for more details.

    One thing I found is that often module files download from the
Internet are often compressed in zip format, even if the file
extension doesn't indicate that it is.  For example you can download a
file called "song.mod" which is really a zip file.  TiMidity does not
automatically detect this and says the file is not a MIDI file.  If
you rename the file to "song.zip" TiMidity will know it is zip and
will play the mod file stored in the zip.

    The default user interface is the dumb interface.  Use the option
"-in" to get the somewhat better ncurses interface.  Use "-int" to
active tracing so you can see the notes dance across the screen.

    It has trouble finding the timidity.cfg file if you don't tell it
where it is. You may need to use the -c option and the -L option.

    See README.cfg and README.sf for information on the timidity.cfg
file.

Darwin O'Connor
doconnor@reamined.on.ca
-----------------------------------------