Search code examples
eclipsemavenjarpom.xmlxuggler

Beginner's Guide to Setup Xuggler

To work with Xuggler you need xuggle-xuggler-5.4.jar. According to the people who made this, most users only need the above-mentioned JAR file. However, this is what they say about using Xuggler without Maven or Ivy:

Using Xuggler WITHOUT Apache Maven or Apache Ivy

What are you... stuck in 2003? Anyway, if you insist on this, Xuggler's pre-compiled binaries (including native versions) can be found here. Make sure that xuggle-xuggler.jar and its dependencies are included in your Java classpath. See the xuggle-xugger-*.pom file distributed with the version of Xuggler that you use to find the (small) set of dependent jars, and download them as well.

I downloaded the xuggle-xuggler.jar file for the latest version, 5.4 but I don't understand the pom file for it.

  • What dependencies is he talking about?
  • Next, how do I download these dependencies ?
  • Once I get these dependencies, how do I start working in Eclipse?

    • Update After Downloading Dependencies

    I have the following directory structure:
    enter image description here

  • xuggle-xuggler-5.4.jar is stored in E:\xuggle
    • enter image description here
  • the various xuggler dependencies are stored in E:\xuggle\xuggle-dependencies

    • Question:

  • How do I start working with Xuggler in Eclipse? What paths do I have to set and what values do these paths have?

    • Solution

  • The following files list the other jars which xuggle depends upon:

    You can read these and then manually retrieve them from the appropriate repository, but I would submit it's simpler to start using a dependency manager.

    You asked how to download these dependencies, well ivy has a convenient command-line mode of operation. (See example below)

    Eclipse integration is very tough.... Once you've downloaded the jar you could try and generate the ".classpath" file or just manually add each jar via the Eclipse GUI. The reason I don't recommend this approach is because there are Eclipse plugins for both Maven and Ivy that would do this for you automatically.

    Example

    Run ivy from command-line as follows:

    java -jar ivy.jar -settings ivysettings.xml -dependency xuggle xuggle-xuggler 5.4 -retrieve "lib/[artifact]-[revision].[ext]"

    It will retrieve xuggle and all its dependencies into a "lib" directory as follows:

    ├── ivysettings.xml
└── lib
    ├── commons-cli-1.1.jar
    ├── logback-classic-1.0.0.jar
    ├── logback-core-1.0.0.jar
    ├── slf4j-api-1.6.4.jar
    └── xuggle-xuggler-5.4.jar

    ivysettings.xml

    This file tells ivy to retrieve jars from either Maven Central, or the Maven repository provided by the Xuggle project.

    <ivysettings>
    <settings defaultResolver="repos" />
    <resolvers>
        <chain name="repos">
            <ibiblio name="central" m2compatible="true"/>
            <ibiblio name="xuggle" m2compatible="true" root="http://xuggle.googlecode.com/svn/trunk/repo/share/java"/>
        </chain>
    </resolvers>
</ivysettings>