Inspect a video file with Xuggler

This is an example that shows how to inspect a video file with Xuggler in order to obtain useful information about it.

These are the basic steps you need to take:

  • Create a Xuggler IContainer object.
  • Open up the container using container.open(filename, IContainer.Type.READ, null).
  • Query how many streams the call to open found using container.getNumStreams().
  • Query for the total duration using container.getDuration()
  • Query for the bit rate using container.getBitRate().
  • Iterate through the streams to print their meta data.
  • Get the pre-configured decoder that can decode this stream using IStreamCoder to obtain several information.

Here is the code:

package com.javacodegeeks.xuggler.intro;

import com.xuggle.xuggler.ICodec;
import com.xuggle.xuggler.IContainer;
import com.xuggle.xuggler.IStream;
import com.xuggle.xuggler.IStreamCoder;

public class VideoInfo {

    private static final String filename = "c:/myvideo.mp4";

    public static void main(String[] args) {

  // first we create a Xuggler container object

  IContainer container = IContainer.make();

  // we attempt to open up the container

  int result = container.open(filename, IContainer.Type.READ, null);

  // check if the operation was successful

  if (result<0)

throw new RuntimeException("Failed to open media file");

  // query how many streams the call to open found

  int numStreams = container.getNumStreams();

  // query for the total duration

  long duration = container.getDuration();

  // query for the file size

  long fileSize = container.getFileSize();

  // query for the bit rate

  long bitRate = container.getBitRate();

  System.out.println("Number of streams: " + numStreams);

  System.out.println("Duration (ms): " + duration);

  System.out.println("File Size (bytes): " + fileSize);

  System.out.println("Bit Rate: " + bitRate);

  // iterate through the streams to print their meta data

  for (int i=0; i<numStreams; i++) {

// find the stream object

IStream stream = container.getStream(i);

// get the pre-configured decoder that can decode this stream;

IStreamCoder coder = stream.getStreamCoder();

System.out.println("*** Start of Stream Info ***");

System.out.printf("stream %d: ", i);

System.out.printf("type: %s; ", coder.getCodecType());

System.out.printf("codec: %s; ", coder.getCodecID());

System.out.printf("duration: %s; ", stream.getDuration());

System.out.printf("start time: %s; ", container.getStartTime());

System.out.printf("timebase: %d/%d; ",



System.out.printf("coder tb: %d/%d; ",




if (coder.getCodecType() == ICodec.Type.CODEC_TYPE_AUDIO) {

    System.out.printf("sample rate: %d; ", coder.getSampleRate());

    System.out.printf("channels: %d; ", coder.getChannels());

    System.out.printf("format: %s", coder.getSampleFormat());


else if (coder.getCodecType() == ICodec.Type.CODEC_TYPE_VIDEO) {

    System.out.printf("width: %d; ", coder.getWidth());

    System.out.printf("height: %d; ", coder.getHeight());

    System.out.printf("format: %s; ", coder.getPixelType());

    System.out.printf("frame-rate: %5.2f; ", coder.getFrameRate().getDouble());



System.out.println("*** End of Stream Info ***");




This was an example on how to inspect a video file with Xuggler.

Related Article:

Ilias Tsagklis

Ilias is a software developer turned online entrepreneur. He is co-founder and Executive Editor at Java Code Geeks.
Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Inline Feedbacks
View all comments
Back to top button