Downloading HTk

This page describes how to download the documentation, binary bundles and sources for HTk.

Installing HTk document bundles

HTk documentation is bundled separately from the binaries, as it is system-independent. The name for the document bundle is of the form uni-docs-[htk-version]-[archive-extension]. So for example the document bundle for version 1 of HTk will have filename uni-docs-1.tar.gz or uni-docs-1.tar.gz Here are the currently available document bundles Simply unpack one of these bundles. You will get a new directory called uni-docs. There is lots of documention within; see the README file to get started.

Installing HTk binary bundles

What You Need

We (try to) support the following operating system/architecture combinations:

You will also need Glasgow Haskell. Get it from here: http://www.haskell.org/ghc

The binary bundle name is of the form uni-[htk-version]-[operating system]-ghc-[GHC version].[archive extension] So for example the binary bundle for version 1 of HTk for Windows with GHC 5.02 will have filename uni-1-windows-ghc-5.02.tar.gz or uni-1-windows-ghc-5.02.zip

Here are the currently available binary bundles

To actually run HTk programs, you will need wish or tixwish. tixwish is an improved version of wish, but nearly all of HTk will work with both.

To see if you already have wish, type wish into a normal command window. If your system finds it, you should see a graphics window and a new command prompt (%). Type 

   info tclversion
at the command prompt and you should get a version number. HTk needs this version to be at least 8.0; and on Windows it must be at least 8.1.1. If you not have wish, or your version is too old, you can get an up-to-date version from http://www.tcltk.com.

The instructions for tixwish are similar (even the version numbers are the same), but the place to get new versions is http://tix.sourceforge.net

How to Install the Binary Bundle

First of course you need to unpack it. On Windows this may be done automatically by your browser, or by a tool which just starts by packing it. On Unix you can unpack the bundle as follows: if the name of the bundle file ends with ".tar.gz" use 
   gzip -cd <[bundle] | tar -xvzf -
and if it ends with ".zip" use 
   unzip -U [bundle]
If the software for unpacking the bundle is not installed on your machine you will have to install it. You can get free software for unpacking .tar.gz files from http://www.gnu.org/software/tar/tar.html, and for unpacking .zip files from http://www.info-zip.org. When you have unpacked the bundle, you will get a new directory called "uni".

You should now have a subdirectory called uni. (Hopefully, you will not need the bundle file again.) Open a normal command prompt window (a normal shell prompt on Unix or Linux, or an MS-DOS prompt on Windows). Go into this subdirectory, and type

This creates two very simple scripts, ghchtk (GHCHTK.CMD on Windows NT; GHCHTK.BAT on Windows 98) and ghcihtk (GHCHTK.CMD on Windows NT; GHCHTK.BAT on Windows 98), which both invoke Glasgow Haskell, giving you access to HTk. ghchtk invokes Glasgow Haskell as a compiler (like ghc) and ghcihtk invokes it as an interpreter (like ghci).

Now modify your PATH to include

The installation is now complete. To test it, do (on Unix or Linux) 

   cd htk/examples/intro
   ghchtk MainhsMines.hs -o hsMines
or on Windows 
   cd htk\examples\intro
   ghchtk MainhsMines.hs -o hsMines
You should now have an executable hsMines. If you want to use wish, run it 
   hsMines
If you instead want to use tixwish you need to specify this, either on the command line, thus 
   hsMines --uni-wish=tixwish
or by first setting an environment variable, for example with Unix or Linux with bash or sh 
   UNIWISH=tixwish
   export UNIWISH
or for Windows with 
   SET UNIWISH=tixwish
A well-known game should appear.

HTk Sources

You are very much welcome to look at the sources of HTk. For this, you need the sources for the Uniform Workbench. We prefer you pick this up from our our CVS server, since you will always get the latest version. However, if you have no access to CVS (e.g. if you are behind a firewall), here is a snapshot of the sources at the time of the binary releases above:
George Russell
Last modified: Thu Jul 11 20:15:57 MEST 2002