# Julius-rs (WIP)

Julius bindings for Rust.

# Installation
This crate works with Cargo. Simply add the following to your `Cargo.toml` file
```rust
[dependencies.julius]
git = "git://github.com/jxny/julius-rs"
```

Or, you can use `julius` from [crates.io](https://crates.io/crates/julius):
```rust
[dependencies.julius]
julius = "*"
```

# Quickstart

````rust
extern crate julius;

use std::path::Path;

let path = Path::new("/path/to/your/jconf/file.jconf");

// load configurations from a jconf file
let mut julius = julius::Julius::load(&path).unwrap();

julius.on_recognition(|sentence| {
  println!("{}", sentence);
});

julius.open_stream().unwrap();
````

# Advanced use
_TODO..._

# Julius
[Wikipedia](http://en.wikipedia.org/wiki/Julius_(software)):

>Julius is a high-performance, two-pass large vocabulary continuous speech recognition (LVCSR) decoder software for speech-related researchers and developers.

Don't forget to checkout the [JuliusBook](http://julius.sourceforge.jp/juliusbook/en/).

# Setting up Julius Step-by-Step (OSX)
###### Checkout the [installation guide](http://julius.sourceforge.jp/juliusbook/en/desc_install.html) first.

1. You'll need to compile from [source](http://julius.sourceforge.jp/en_index.php?q=index-en.html)
2. `./configure`
3. `make`
4. `make install`
5. Make sure both `libsent.a` and `libjulius.a` are in your lib dir (`/usr/local/lib`).

# Important

* Only tested on (Mac) OS X (I don't have access to any other OS atm but feel free to fork it and submit a pull-request).