Downloading & Installing

The Xuggler is composed of two main components; a set of Java jar files, and a set of native shared libraries ( .dll files on Windows, .so files on Linux, or .dylib files on Mac). To use you need to first install the native libraries, and then you can write programs that use the Xuggler. Here's the details for installing the core Xuggler library.

Download

Choose the release you want, select the right package for your operating system, and then follow the Quick Install instructions.

Release
Version Xuggler LGPL 3.4 - "Forrest"
Date 01-February-2010
Description

Forrest is a new feature & performance release. Specifically it includes:

  • Xuggler can now read and write to rtmp: URLs.
  • Xuggler now supports H264 B-Frame encoding and the latest X264 encoder.
  • Xuggler H264 decoding is now over 10% faster.
  • Xuggler now supports FFmpeg preset files.
  • Xuggler now supports AMR audio encoding.
  • Xuggler exposes the latest FFmpeg seek functionality.

For details, the release notes are here.

If you experience any issues, please let us know by joining the Xuggler Users group and dropping us a line.
License LGPL v3
OS Download
Windows
Windows Vista or XP		 32 Bit, Java 1.5 or later xuggle-xuggler-setup.exe

Linux		 32 Bit, Java 1.5 or later xuggle-xuggler-i386-linux.sh
64 Bit, Java 1.5 or later xuggle-xuggler-x86_64-linux.sh

Mac OS-X 10.5 or higher		 64-Bit, Java 1.6 xuggle-xuggler-apple-darwin9.8.0.sh
Source Code xuggle-xuggler.3.4.1012-src.tar.gz

Prior Releases »

Installation

OS Quick Install
Windows
Windows Vista or XP 32 bit

First, uninstall any prior releases of Xuggler. Then run the installer you downloaded above.

Linux

The install binaries for Xuggler on Linux are built on Ubuntu Jaunty for Intel 32-bit or 64-bit processors. If you need support for other operating systems, you must build Xuggler binaries yourself

First, remove your previous installation (from whatever directory you installed it in). If you installed it to its own directory, just remove the directory.

Then, download the installer and run (assuming you called the downloaded file xuggle-xuggler.sh):

chmod a+x ./xuggle-xuggler.sh
./xuggle-xuggler.sh

If you choose to install into a protected directory, you may need to do:

sudo ./xuggle-xuggler.sh

Lastly, make sure every program using Xuggler has the environment variables defined that the installer tells you to set up.

Mac OS X

The install binaries for Xuggler on Mac OS X only support Intel Macs and Java 1.6. If you need support for other operating systems, you must build Xuggler binaries yourself

First, remove your previous installation (from whatever directory you installed it in). If you installed it to its own directory, just remove the directory.

Then, download the installer and run the following from a bash terminal (assuming you called the downloaded file xuggle-xuggler.sh):

chmod a+x ./xuggle-xuggler.sh
./xuggle-xuggler.sh

If you choose to install into a protected directory, you may need to do:

sudo ./xuggle-xuggler.sh

Lastly, make sure every program using Xuggler has the environment variables defined that the installer tells you to set up.

Running Xuggler From Eclipse

Eclipse ignores the environment settings you set in your bash shell, so you need to tell Mac OS X to set your envionrment settings login-wide. To do that, create the following file:

~/.MacOSX/environment.plist

And edit it so it contains the following text (replace the path with the value the installer tells you to use for DYLD_LIBRARY_PATH). For example:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
 "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>DYLD_LIBRARY_PATH</key>
    <string>/usr/local/xuggler/lib</string>
  </dict>
</plist>

Then log out and log back in.

Using Xuggler

Once you've successfully installed Xuggler you may want to actually use it in your programs. For that, may we suggest you check out our Tutorials.

Read Xuggler Tutorials »

Getting Latest "Tip of Tree" Sources

We occasionally release "official releases" of Xuggler as above, and they should install without issue (hopefully). However, sometimes if you run into issues installing, or just want the bleeding edge tip of tree source code, you may want to dig deeper. Therefore, we also provide more detailed information on what's actually going on.

Read Building Xuggler »

Licensing

Xuggler is licensed under the GNU Lesser General Public License v3 (LGPL). See the COPYING and COPYING.LESSER files in each library for details.