AudioImager

Download Source Code of AudioImager Standalone Application

2011-12-28T02:29:00.003-08:00

You can also download all the source code of AudioImager standalone application from here.

This is written in Java. Xuggler and FFMPEG libraries are used for video rendering.
If you are interested in contributing to this project please contact kumaripaba.athukorala@hiit.fi

How to use AudioImager?

2010-11-22T11:27:00.000-08:00

It's very easy to use AudioImager. Few simple steps to follow.

Prerequisites
1. Install Xuggler
2. Install JRE 1.6

*You may have to restart your computer after installing Xuggler and JRE.

Next Download AudioImager
If you are a Windows user double click the AudioImager BATCH file to run AudioImager.
If you are using any other operating system run the AudioImager JAR file.

Now You can Enjoy AudioImager.

Latest Look of AudioImager

2010-07-16T02:23:00.001-07:00

This is how AudioImager looks now. This project has reached the middle of its project time line.

Given below is a video generated through AudioImager

Phase 1 Part 1 - Planned User Intarface

2010-05-27T06:40:00.001-07:00

This is how the application will look after the completion of the first three weeks of phase one.
You can select any image from the timeline then it's details will be displayed as shown in the diagram. The details will include start time and end time. If you increase the start time the end time of the previous image will automatically be reduced.

FMJ or JMF ??

2010-05-16T11:27:00.001-07:00

Last couple of weeks I've been experimenting with FMJ (Freedom for Media in Java) and JMF (Java Media Framework). FMJ sounds promising, but according to my research it does not support everything I need in my application.

First I tried to create a video with a set of images. It works with JMF. But unfortunately there are no codecs for video formats available in FMJ.

Given below are the Media formats supported by FMJ. Even in FMJ forums it is asked to use JMF in places where certain codecs are missing in FMJ.

Pure Java processing and playback

Container	Format	Decode (D), Encode (E)
RTP	JPEG/RTP	D,E
	ULAW/RTP	D,E
	ALAW/RTP	D,E
	SPEEX/RTP	D,E
	ILBC/RTP	D,E
WAV	LINEAR (PCM)	D,E
AU	LINEAR (PCM)	D,E
	ULAW	D,?
AIFF	LINEAR (PCM)	D,E
multpart/x-mixed-replace	JPEG	D,E
	GIF	D,E*
	PNG	D,E
Ogg	VORBIS	D
	THEORA	D
MP3	MP3	D

* - encoding only with Java 6+

Testing QuickTime for Java

2010-05-01T08:24:00.001-07:00

I am experimenting with various media supporting libraries for Java these days. Java Media Framework (JMF) in the previous post is one of them.
I also found this interesting library provided by QuickTime. But it works only with QuickTime player. Given below are the steps I followed and a sample code I tested.

The first step is to install QuickTime. In QuickTime you can find a the java library QuickTime for Java in the part QuickTime/QTSystem/QTJava.zip. This QTJava.zip contains all the libraries needed.
I imported this QTJava.zip to Eclipse and tried the following sample code provided in QuickTime for Java Wiki page (http://en.wikipedia.org/wiki/QuickTime_for_Java).

import java.io.File;
import java.awt.*;

import quicktime.*;
import quicktime.std.movies.Movie;
import quicktime.app.view.QTFactory;
import quicktime.io.*;
import sun.audio.AudioPlayer;

public class TrivialQTJPlayer extends Frame {
public static void main (String[] args) {
try {
QTSession.open();
Frame f = new TrivialQTJPlayer();
f.pack();
f.setVisible (true);
} catch (Exception e) {
e.printStackTrace();
}
}
public TrivialQTJPlayer()
throws QTException {
FileDialog fd = new FileDialog
(this, "TrivialJMFPlayer", FileDialog.LOAD);
fd.setVisible(true);
File f = new File (fd.getDirectory(), fd.getFile());
OpenMovieFile omf = OpenMovieFile.asRead (new QTFile (f));
Movie m = Movie.fromFile (omf);
Component c = QTFactory.makeQTComponent(m).asComponent();
add (c);
m.start();
}

}

This code creates a QTJ player and you have to give a *.mov file as input for this sample. There are many other file types supported by QT for Java.
The only constraint with this is that you must have a QuickTime player to run any application you've written by using QuickTime for java.

My Proposal for AudioImager got accepted to GSoc 2010

2010-04-27T12:06:00.000-07:00

The proposal for AudioImager got accepted for GSoc 2010. This is a great opportunity for me to put my ideas on AudioImager forward and continue implementing this interesting software.
There's a lot more research to be done within this month before I commence real coding. Updates on my research will appear soon..

Testing with Java Media Framework

2010-04-09T12:18:00.000-07:00

I did a small experiment with Java Media Framework. Following tutorial was very helpful in my experiment - http://www.scribd.com/doc/6552759/Jmf-Tutorial

I created a simple audio player with JMF. For this, I basically used the Manager class and the Player interface in JMF library.

Given below is the source code of the simple program I wrote for audio player example.

import javax.media.*;

import java.io.File;
import java.io.IOException;
import java.net.URL;
import java.net.MalformedURLException;

public class SimpleAudioPlayer {

private Player audioPlayer = null;

public SimpleAudioPlayer(URL url) throws IOException, NoPlayerException,
CannotRealizeException{
audioPlayer = Manager.createRealizedPlayer(url);
}
public SimpleAudioPlayer(File file) throws IOException,
NoPlayerException,
CannotRealizeException{
this(file.toURL());
}
public void play(){
audioPlayer.start();
}
public void stop(){
audioPlayer.stop();
audioPlayer.close();
}

public static void main(String args[])
{
File audioFile = new File(args[0]);
try {
SimpleAudioPlayer player = new SimpleAudioPlayer(audioFile);
player.play();
try {
Thread.sleep(10000); //play the song for 10 seconds
} catch (InterruptedException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
player.stop(); // stop the player
} catch (NoPlayerException e) {
e.printStackTrace();
} catch (CannotRealizeException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}

}

}

* Here the Manager class acts as the factory for creating many of the interface types exposed in JMF.

* We create the Player instance using this Manager class

I tested this code with the command-line interface. You can pass any audio file supported by JMF. I tested it with MP3 and WAV.

Proposed UI for Editing

2010-04-08T10:01:00.001-07:00

Proposal

2010-04-08T09:55:00.000-07:00

About You

I am a final year master student following Masters in Information Engineering at Faculty of Technology, University of Oulu, Finland. Before commencing my master’s studies, I completed a 4 year bachelor’s degree in Computer Science and Engineering at Department of Computer Science and Engineering, University of Moratuwa, Sri Lanka. You can find my LinkedIn profile at http://fi.linkedin.com/pub/kumaripaba-athukorala/20/319/9b4

I have involved in several projects during my bachelor studies and master studies.

The most recent project I involved in was the implementation of a money order handling system. I got involved in this project while I was working at the department of Computer Science and Engineering, University of Moratuwa. It is a web application developed in LAMP. Here I involved in the development of the server side scripts (in PHP) and design of the database. This project was a great success and currently deployed and used by the government.

I was an employee of Codegen Internation (http://www.codegen.net/), Sri Lanka for a period 6 months and during this period I contributed to the development of a module named Tour Package Builder, for the project TravelBox (in Java).

During the final year of my bachelor’s studies I was engaged in the development of a Home Automation and Monitoring System for Mobile Devices. This was a one year long research project conducted by three members as a requirement of the bachelor’s program. In this project I contributed to the development of the Home Configuration tool (in Java), design of the database (in mysql), server side scripting (in PHP). (See project Video: http://dsmartdraw.blogspot.com/). The research conducted for this project was published at IEEE conference NGMAST’09.

During my undergraduate period I went through industrial training for a period of 9 months at a local IT firm, where I involved in two different projects. In the first project my responsibility was to contribute to the development team of the project which developed a VoIP call center solution based on Skype API. Technologies such as ASP.net, MS-SQL 2000,.Net charts were used in developing this system. My second project was SuperOffice. Super Office is a CRM widely used in European companies. In this project, my responsibility was to develop the API document for the developers.

I decided to participate in Google Summer of Code-2010 due to several reasons. The first reason is that I need to spend this summer in a very productive manner, therefore I realized that engaging in GSOC is the best mode of occupying my summer. And also I like to contribute to the open source community and this is one of the best opportunities for that. And also for my masters program, it is required for me to undergo at least two months of fulltime industrial training and participation in GSoc is also accepted as industrial training.

I specifically selected a Berkman project because it is research oriented. I am more interested in researching and my area of specialization is intelligent systems. Therefore I was searching for a research oriented project related to my area of interest and the project AudioImager perfectly matches this criteria. After this summer I am planning to commence my master’s thesis, therefore I believe that the experience I am going to gain from this project will help me a lot in finding a topic and a position for my thesis.

I have thoroughly reviewed the important dates and times of GSOC 2010 and I do not have any significant conflicts with the GSOC 2010 schedule. I do understand that this is a serious commitment and I am anyway looking for a similar commitment.

Proposal

Overview

The main requirements of the project AudioImager is to implement a software which automatically selects suitable images for an audio and generates a video for this audio. In order to provide this major requirement this software needs the following basic components.

1. Interface for the user to provide the audio file

2. Lyrics search engine to find the lyrics of the audio.

3. Image search engine to find suitable images for the audio

4. Place lyrics, images and audio in the timeline.

5. Provide an interface for the user to edit the lyrics, change the images, test the video

I propose this system to be implemented in two main phases. The first phase will basically involve finding lyrics of the audio and bringing it to a standard format. Hence the component number 1 and 2 will be implemented by the end of this phase.

In the second phase the lyrics will be broken in to meaningful phrases, images are searched for these phrases and they are provided in a timeline. This mainly involves the creation of a user-friendly interface which lets the user remove the software suggested images and insert user’s own images and changing the lyrics. The user can also change the duration in which a particular image is shown. Hence by the end of this phase the rest of the components will be implemented.

Testing will be carried out throughout the implementation process. I would like to implement this project in Java. Java Media Framework (JMF) can be utilized in this project. The first version of this project will be implemented as a desktop application.

Detailed

I propose this application to be developed in two main phases. The major goals of the first phase are given below.

1. Provide an interface for the user to input the audio file and select the intended use of the video.

2. Search for lyrics of the audio file

a. I propose this to be implemented by using the information in the header of the audio file. Most of the files contain details about the file in the header. These details include information such the title of the file, author of the file and etc. This information will be very helpful in this phase. But the header formats vary from file format to format. To make it possible to extract the headers from every format, it would require to read many specks and this would consume a lot of time. Therefore I’m planning to implement header reading only for one popular file format and for other formats, the application will prompt the user to enter the title and the author information.

b. The earlier suggestion for this project was to extract the lyrics through speech recognition. But after researching about this, it is found that most of the open source voice recognition software isn’t very accurate. And also they require creation of an acoustic model using former voice cuts of the speaker. This would not be feasible in the given timeframe. Therefore it is the best to get the lyrics by searching through the web. For this I am planning to use web scraping.

3. Bring the lyrics to a standard format.

a. Generally the lyrics can have various formats. But here our concern is on the key words or meaningful phrases in the lyrics. To find them we have to first fill all the gaps or missing information in the lyrics and bring it to a standard format.

The above three tasks end the first phase. In the second phase the following goals will be achieved.

1. Break the lyrics in to meaningful phrases (keywords).

a. This requires little bit of research. I suggest to break the lyrics initially in to chunks of N words. Then search for an image for each chunk. If there’s no image for that given chunk, remove word by word from the chunk until you receive an image. This is one possible method of doing this. But I am planning to allocate sometime to research on this first.

2. Search for suitable images for the keywords.

a. After breaking the keywords we can select the image results for that phrase. Images that permit the intended use of the video will only be selected.

3. Implement the user interface.

a. It provides the images in a timeline.

b. User can add his/her own images too. Remove the software selected images. Change the duration in which the image is displayed.

c. Similarly the user can change the keywords (Lyrics). Can add new keywords, delete existing keywords.

d. User can preview video.

4. Testing the application.

Project Plan

Plan for First Trimester: 26 April – 23 May

I will spend this period on researching on following areas.

1. Study the header format of a popular audio file format

2. Research on web scraping

3. Work with Java Media Framework (JMF) and research on how it supports the development of this project

4. Research on breaking the lyrics in to meaningful phrases.

Plan for Second Trimester: 24 May – 12 July

I will spend this period on implementing the first phase of the project.

1. Implement a simple interface for the user to enter:

a. The audio file

b. Select the intended use of the video from a drop down list.

2. Check the format of the file and prompt the user to enter the author name and the title if it is not of the given format.

3. Implement the lyrics search engine.

a. It will search for lyrics using web scraping.

4. Bring the lyrics to a standard format.

5. Break the lyrics to meaningful phrases (keywords).

Plan for Third Trimester: 13 July – 9 August

I will spend this period on implementing the second phase of the project.

1. Obtain images matching to these phrases.

2. Design the main interface with following features.

a. Area to display the images in a timeline

b. Audio timeline

c. Lyrics in a timeline

d. Display additional images for the user to select from in a separate area.

e. Provide user the facility to browse an image.

f. Preview the video.

g. Save video.

h. Provide the user the facility to edit/remove/insert a keyword.

3. Implement the features in the interface.

4. Testing.