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.io.File;
import java.io.IOException;
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 = ImageIO.read(new 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:

Byron Kiourtzoglou

Byron is a master software engineer working in the IT and Telecom domains. He is an applications developer in a wide variety of applications/services. He is currently acting as the team leader and technical architect for a proprietary service creation and integration platform for both the IT and Telecom industries in addition to a in-house big data real-time analytics solution. He is always fascinated by SOA, middleware services and mobile development. Byron 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