The libshout-java bindings are a very literal iterpretation of the libshout api. The only significant change is that libshout errors generate exceptions, so that they may be handled with the java exception mechanism. Most of the core functionality of libshout is available, including connecting, metadata, etc, however, there are a few unimplemented pieces. Contributions are welcome, or let me know if you need some functionality which has not been exposed.

Requirements

• linux, freebsd, win32 (via MinGW), a jdk
• cc/gcc,make/gmake
• libshout 2.x
• icecast2
• ant for building sources

Download

• libshout-java nightly CVS build
• libshout-java 0.6 - Jun 12 2007

  - republished after data loss
  - Fixes packaging problem.

• libshout-java 0.5 - Dec 1 2006

  - revalidated linking under ubuntu/amd64. Compiles and runs fine, expanded and improved example.

• libshout-java 0.4 - Feb 2 2005

  - Siarhei Dudzin contributed support of multiple simultaneous streams and MinGW compilation

• libshout-java 0.2 - Jan 25 2003

  - Renaud Waldura contributed support for freebsd
  - Misc fixes

• libshout-java 0.1 - Dec 14 2003

  - Basic bindings
  - Compilation within Linux

Documentation

The javadocs for libshout-java may be viewed here.

CVS

libshout-java can be checked out from cvs.

Compilation, Installation & Usage

Source can be built by issuing ant in the top-level directory. Other ant commands include ant javadoc to generate the javadocs, or ant -projecthelp for the full listing.

Once compiled, you may want to execute the included example through sh bin/example, though you may have to edit the example java source directly to match your icecast setup. Take a look at bin/example for the required java flags (ie -Djava.library.path) when using libshout-java in your own application.

Contact

Please contact me if you have any questions, comments or requests.