Windows binary package of Julius-4.0
=====================================

This archive contains Win32 binaries and documents of Julius Rev.4.0.

To know about this release, see "00readme-julius.txt" and "Release.txt".

Directory "doc" contains documents in plain txt, man, and PDF format.
Included documents are Julius reference manual, jconf configuration
reference manual, JuliusLib API specifications, callback list, etc.
If you are new to Rev.4.0, please take a time to read through them.

The Web site contains many other documentations and a soucrce code
browser updated for Rev.4.0.  They may also help you.

	http://julius.sourceforge.jp/


Running environment
====================

The binaries included in this package will run on most Windows,
including 2000, XP and Vista.  To do live recognition of microphone
input.  16kHz, 16bit, monoral recording should be supported on your
audio input device and DirectSound should be installed.

Perl is needed run the recognition grammar construction tools.
They are tested on cygwin, MinGW+MSYS and ActivePerl.

The binaries are compiled on MinGW-5.1.0 on Windows Vista.


JuliusLib
==========

From rev.4.0, the core engine part is modularized into a library
called "JuliusLib".  the header files are located in "include",
and pre-compiled static libraries are located in "lib".

Directory "julius-simple" contains a sample program to compile with
JuliusLib.  It is a simplified version of Julius to start recognition
according to the given command argument as same as Julius, and output
result to stdout.  It can be compiled by the following commands 
on cygwin or mingw environment.

      % cd julius-simple
      % make

See also the followings to learn how to use the JuliusLib.

   - julius-simple/julius-simple.c		sample code
   - doc/Julius-API-reference-4.0.pdf		API reference
   - doc/Julius-callback-reference-4.0.pdf	l of callbacks
   - Jconf-manual.pdf				Jconf configuration manual


Julius and tools
=================

Binaries are located in bin/ :

    [Main]
    julius-*.exe    Julius

    [Tools]
    mkbingram.exe   convert 2-gram and reverse 3-gram to binary format
    mkbinhmm.exe    convert ascii hmmdefs to binary hmmdefs
    mkgshmm	    make GSHMM for Gaussian Mixture Selection
    mkss.exe	    compute noise spectrum from mic for spectral subtraction

    [Utilities]
    adinrec.exe	    record one sentence from microphone to a file
    adintool.exe    enhanced adinrec with segmentation and network support
    jcontrol.exe    sample client for Julius/Julian module mode

    [Grammar construction tools for Julian]
    mkdfa.pl	      grammar compiler
    accept_check.exe  grammar accept check tool
    generate.exe      randam sentence generator for grammar
    generate-ngram.exe random sentence fenerator for N-gram
    yomi2voca.pl      convert Japanese Hiragana into phonemes
    dfa_minimize.exe  minimize DFA states
    dfa_determinize.exe determinize DFA states

<    [Result scoring tools]
    scoring/	    Recognition result evaluation scripts


Documents
=================

    00readme.txt	 About this package
    00readme-julius.txt	 Julius-4.0 readme
    LICENSE.txt		 Terms and conditions to use
    Release.txt	         Release notes and detailed changelog.
    Sample.jconf         Sample runtime config file for Julius.
    doc/                 Manuals, References, API documents and others.

You can get more information on the Julius Web page:

	 http://julius.sourceforge.jp/


Have a model?
===============

Julius/Julian needs language model and acoustic model to run as a 
speech recognizer.  Please consult the web page for availability.
