Byron Kiourtzoglou

About Byron Kiourtzoglou

Byron is a master software engineer working in the IT and Telecom domains. He is always fascinated by SOA, middleware services and mobile development. Byron is co-founder and Executive Editor at Java Code Geeks.

Modify video file with Xuggler example

With this example we shall show you how to modify video file using Xuggler in a Java Desktop Application.So, let’s suppose we wish to add a static image to our video and at the same time we wish to reduce the audio volume.

Here are the basic steps you need to take:

  • Create a IMediaReader to read the video file.
  • Configure it to generate BufferImages using mediaReader.setBufferedImageTypeToGenerate.
  • Create an IMediaWriter using ToolFactory.makeWriter.
  • Create a new IMediaTool calling StaticImageMediaTool(imageFilename).
  • Create a new IMediaTool for the audio using new VolumeAdjustMediaTool(0.1).
  • Create a tool chain: reader -> addStaticImage -> reduceVolume -> writer.
  • Create a class tha extends MediaToolAdapter.
  • Override onVideoPicture method. This will help you insert the image in the position you want.

Let’s see the code that implements all the above:

package com.javacodegeeks.xuggler;

import java.awt.Color;
import java.awt.Graphics2D;
import java.awt.geom.Rectangle2D;
import java.awt.image.BufferedImage;
import java.nio.ShortBuffer;

import javax.imageio.ImageIO;

import com.xuggle.mediatool.IMediaReader;
import com.xuggle.mediatool.IMediaTool;
import com.xuggle.mediatool.IMediaWriter;
import com.xuggle.mediatool.MediaToolAdapter;
import com.xuggle.mediatool.ToolFactory;
import com.xuggle.mediatool.event.IAudioSamplesEvent;
import com.xuggle.mediatool.event.IVideoPictureEvent;

public class ModifyMediaExample {

    private static final String inputFilename = "c:/myvideo.mp4";
    private static final String outputFilename = "c:/myvideo.flv";
    private static final String imageFilename = "c:/jcg_logo_small.png";

    public static void main(String[] args) {

  // create a media reader

  IMediaReader mediaReader = ToolFactory.makeReader(inputFilename);

  // configure it to generate BufferImages


  IMediaWriter mediaWriter = 

   ToolFactory.makeWriter(outputFilename, mediaReader);

  IMediaTool imageMediaTool = new StaticImageMediaTool(imageFilename);

  IMediaTool audioVolumeMediaTool = new VolumeAdjustMediaTool(0.1);

  // create a tool chain:

  // reader -> addStaticImage -> reduceVolume -> writer




  while (mediaReader.readPacket() == null) ;


    private static class StaticImageMediaTool extends MediaToolAdapter {

  private BufferedImage logoImage;

  public StaticImageMediaTool(String imageFile) {

try {

    logoImage = File(imageFile));


catch (IOException e) {


    throw new RuntimeException("Could not open file");




  public void onVideoPicture(IVideoPictureEvent event) {

BufferedImage image = event.getImage();

// get the graphics for the image

Graphics2D g = image.createGraphics();

Rectangle2D bounds = new 

  Rectangle2D.Float(0, 0, logoImage.getWidth(), logoImage.getHeight());

// compute the amount to inset the time stamp and 

// translate the image to that position

double inset = bounds.getHeight();

g.translate(inset, event.getImage().getHeight() - inset);




g.drawImage(logoImage, 0, 0, null);

// call parent which will pass the video onto next tool in chain




    private static class VolumeAdjustMediaTool extends MediaToolAdapter {

  // the amount to adjust the volume by

  private double mVolume;

  public VolumeAdjustMediaTool(double volume) {

mVolume = volume;



  public void onAudioSamples(IAudioSamplesEvent event) {

// get the raw audio bytes and adjust it's value

ShortBuffer buffer = 


for (int i = 0; i < buffer.limit(); ++i) {

    buffer.put(i, (short) (buffer.get(i) * mVolume));


// call parent which will pass the audio onto next tool in chain





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

Related Article:

Related Whitepaper:

Java Essential Training

Author David Gassner explores Java SE (Standard Edition), the language used to build mobile apps for Android devices, enterprise server applications, and more!

The course demonstrates how to install both Java and the Eclipse IDE and dives into the particulars of programming. The course also explains the fundamentals of Java, from creating simple variables, assigning values, and declaring methods to working with strings, arrays, and subclasses; reading and writing to text files; and implementing object oriented programming concepts. Exercise files are included with the course.

Get it Now!  

Examples Java Code Geeks and all content copyright © 2010-2014, Exelixis Media Ltd | Terms of Use | Privacy Policy
All trademarks and registered trademarks appearing on Examples Java Code Geeks are the property of their respective owners.
Java is a trademark or registered trademark of Oracle Corporation in the United States and other countries.
Examples Java Code Geeks is not connected to Oracle Corporation and is not sponsored by Oracle Corporation.

Sign up for our Newsletter

20,709 insiders are already enjoying weekly updates and complimentary whitepapers! Join them now to gain exclusive access to the latest news in the Java world, as well as insights about Android, Scala, Groovy and other related technologies.

As an extra bonus, by joining you will get our brand new e-books, published by Java Code Geeks and their JCG partners for your reading pleasure! Enter your info and stay on top of things,

  • Fresh trends
  • Cases and examples
  • Research and insights
  • Two complimentary e-books