Windows binary package of Julius-4.1.3
=======================================

This archive contains Win32 binaries and documents of Julius rev. 4.1.3.
To know about this release, see "00readme-julius.txt" and "Release.txt".

From 4.1.3, Julius also can be compiled with Microsoft Visual C++ 2008.
Please download the source archive (julius-x.x.x.tar.gz), unpack and
see "msvc/00README.txt" for details.


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, not MSVC.


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
    mkbinhmmlist.exe convert HMMList to binary file
    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 module mode
    jclient.pl	    sample client for Julius module mode in Perl.

    [Grammar construction tools]
    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 readme
    LICENSE.txt		 Terms and conditions to use
    Release.txt	         Release notes and detailed changelog.
    Sample.jconf         Sample runtime config file for Julius.
    manuals/             Online manuals

You can get more documents, related information, and developer's forum
on the Julius Web page:

	 http://julius.sourceforge.jp/en/
	 http://julius.sourceforge.jp/forum/


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


Sample Plugins
===============

The "plugin-sample" directory contains sample codes for developing a
plugin for Julius.  The content is the same as the ones included in
the original source archive.  You can compile them by "make" under the
directory.  For further information, see the "00readme.txt" in the
directory and comments on the source codes.


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

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