Compiling Avidemux

From Avidemux2

This article contains information on generally compiling Avidemux, from the SVN repository or from tarballs, for your operating and some custom choices for the compilation. There are general guides, package descriptions and specific information for some Linux distributions that need specific compilation switches to successufully create the program from source.

Information on the compilation

To compile Avidemux, you will need to have the necessary dependencies met. Namely, you will need to install (or have already installed) several development packages. Here is a list and brief description of the packages:

Mandatory packages

• SpiderMonkey: Needed for scripting (only for versions up to 2.3).
• GTK+: Avidemux 2.1-2.3 needs GTK+ 2.6 or newer. That includes also pkg-config, that might be a separate package. Avidemux 2.4 or newer can be built with GTK+, Qt 4 or commandline user interface. The GTK+ version needs GTK+ 2.10 or newer, including Cairo. Some older Linux distributions (e.g. Fedora Core 4) include older GTK+ versions, without Cairo.
• libxml2: XML library, version 2. Used for filter descriptions and ~/.avidemux/config.
• GCC: Source code compiler for Avidemux to be created with.

Optional packages

Audio:

• libmad: MAD is needed for MP3 and MP2 decoding.
• LAME: MP3 audio encoding.
• libvorbis: Vorbis audio encoding and decoding.
• FAAD: AAC audio decoder.
• FAAC: AAC audio encoding.
• a52dec: Audio decoding support for AC3 audio (DVDs & others).
• libdca: Audio decoding support for DTS (DVD and others).

Video:

• Xvid: MPEG-4 SP/ASP encoder.
• x264: MPEG-4 AVC (H.264) encoder.

Miscellaneous:

• FreeType: needed for the Subtitler filter.
• OSS: Open Sound System. Linux kernel 2.6 and newer uses ALSA with optional OSS emulation.
• ALSA: Advanced Linux Sound Architecture. Direct ALSA sound output can be set in Preferences.
• SDL: SDL can be used for audio and video output. Not needed on Linux and BSD.
• XVideo: Hardware display acceleration (overlay) during playback. Lower CPU usage.
• ESD: sound output daemon. Obsolete and not needed.
• aRts: KDE 3.x sound system daemon. Not needed in KDE 4, not recommended.

General compilation instructions

This guide has information on compiling in two ways. The method for both is basically the same, with only one command change at the beginning to download from where you want.

Choosing what to compile

You have two choices for where you can download files to compile.

1. Download the latest stable tarball version from the download page. This is the stable version for those who want a program that is mostly bug free and stable.

svn://svn.berlios.de/avidemux/branches/avidemux_2.4_branch/

1. Download the unstable source files for the latest versions of Avidemux from the SVN repository. The SVN version is usually the latest development version which can contain some bugfixes and also new features. It is classified as unstable or testing, though it really is quite stable in general. Regardless, we do not recommend using the SVN version to do any work you care about saving - use the stable version from the tarball on the website for that. You can download the source code from SVN using this command:

svn://svn.berlios.de/avidemux/tags/avidemux_2.5.1

Compilation commands

cd avidemux (enter the source code directory)

CMake build

The 2.4 branch uses CMake as its primary build method. You can build Avidemux 2.4 or later using these commands in the source code directory:

1. cmake . (the dot is required)
2. make

For more information, see the Switch to CMAKE in progress thread in the Avidemux forum.

Old method (Avidemux 2.3 and older)

1. make -f Makefile.dist (this is needed if you compile the SVN version, not needed for the official release)
2. ./configure --with-jsapi-include=xxxx [--with-newfaad for Gentoo or Ubuntu] (xxxx is the directory where SpiderMonkey is installed - you cannot compile Avidemux 2.3 or older without SpiderMonkey, version 2.4 does not require external SpiderMonkey anymore)
3. make (compile Avidemux)
4. make install (install Avidemux - you must be root, use the su command for that)

Using the 'locate jsapi.h' command will usually find the directory you need with the jsapi.h file. If the locate command does not find it, you should update the location database with the command 'updatedb' and then re-try 'locate jsapi.h' command.

Some people may not want to have all the feature for Avidemux compiled into their program. Here is a list of ./configure arguments to prevent features from being compiled:

Audio

• OSS: --without-oss
• aRts: --without-arts
• ESD: --without-esd

Video

• XV: --disable-xv

Linux distribution specific notes

Debian (3.0 and beyond)

Currently there is no explicit guide for compiling the latest version of Avidemux from Subversion (SVN) in Debian. However you can follow the Ubuntu/Kubuntu SVN Compile guide on this same page generally with no changes to the process and you should be able to compile just fine.

Deb packages of Avidemux for Debian here:

http://debian-multimedia.org/

Gentoo

You can get the necessary ebuilds for compiling Avidemux from the 2.3 subversion branch from the Berkano Overlay (which includes a couple of other ebuilds that may be useful). For information on how to use third-party ebuilds read the HowTo on the Gentoo Wiki.

Some Gentoo systems need the --with-newfaad argument with the ./configure stage of the compilation.

Ubuntu/Kubuntu/Xubuntu

General downloads for Ubuntu

Enable the universe in your apt-source list. From a root console or via sudo use nano/vim/gedit or whatever text editor you like to open: /etc/apt/sources.list. You should either have the "universe" enabled on one of your repository lines.

After you have made sure the "universe" repository is enabled in your apt-sources file, from a root console or via sudo run this command:

sudo apt-get update

Next we will install the compile dependencies. Running this command line from the root console with either su or sudo will install many of the necessary dependencies for you to compile Avidemux with several extra features.

 sudo apt-get install automake1.9 g++ gcc liba52-0.7.4 \
liba52-0.7.4-dev libfaac-dev libfaad-dev \
libstdc++6 libgtk2.0-dev libglib2.0-dev \
libsdl-console-dev libxv-dev pkg-config \
liblame-dev libmad0-dev libvorbis-dev \
libxml2-dev libxvidcore4-dev subversion

The libmad0 may not be needed anymore, since I think they just changed statically added it to the most recent SVN. Regardless, it cannot hurt.

Download & Compile

Go to the place on your system when you want to download the source files for Avidemux. Make sure that you have Subversion installed. If you followed the previous step, you should be fine. You can choose to use the stable 2.4 branch or the unstable developers 2.5 branch. Using a console as a normal user, run this command:

svn co svn://svn.berlios.de/avidemux/branches/avidemux_2.4_branch/

Now the source files for the latest version of Avidemux from the SVN repositories are on your system, in a directory usually called avidemux_2.x_branch (where 'x' is the specific version you chose to download) at your currect working directory. Move into that directory and create the configure script by running these commands:

cd avidemux_2.x_branch #where 'x' is the specific version you chose to download
make -f Makefile.dist

After make is installed, from a run this command:

make

You now have a compiled executable file in avidemux_2.x_branch/avidemux called avidemux2. This is your new version of Avidemux. You may run it however you like or install it wherever you please.

Optional: make install

At this point you are done and all you need to do is from a console run this command:

sudo make install

Red Hat / Fedora

Red Hat follows the general procedures for compiling but if you run into problems during the ./configure command, try using this variable:

--with-jsapi-include=/usr/local/include/js

For Fedora Core 5 install js and js-devel using yum:

yum install js js-devel

Then run configure with

--with-jsapi-include=/usr/include

Compiling ThreadSafe SpiderMonkey

See the Compiling SpiderMonkey article.

JSAPI compile problems

If you have problems compiling jsapi SpiderMonkey with Fedora, try doing this before you run the ./configure command:

export LD_LIBRARY_PATH="/path/to/libjs.so"

Slackware

Slackware follows the general procedures for compiling but needs this in the ./configure command:

--with-jsapi-include=xxxx

where the xxxx should point to the Spidermonkey installation directory. The easiest way to get Spidermonkey installed on your system is to install the Mozilla Slackware package. This will install the appropriate js files to eg. /usr/lib/mozilla-1.7.13/

Additionally, the *js* files in Mozilla directory should be in your libpath (eg. /usr/lib), so simply symlink them to there. Done!

Some Slackware users have reported problems with GTK+ compiling. We suggest trying to this option when you are compiling. It seems to help

./configure --without-libsdl

In case you get the following error during 'make -f Makefile.dist' :

aclocal:configure.in:117: warning: macro `AM_GNU_GETTEXT' not found in library
*** Creating configure
configure.in:117: error: possibly undefined macro: AM_GNU_GETTEXT

you should install gettext-tools Slackware package.

In case of an error during the 'make install' :

/bin/sh @MKINSTALLDIRS@ /usr/local/share
/bin/sh: @MKINSTALLDIRS@: No such file or directory

do the following:

to be filled in

SUSE

This information is specific to SUSE version 10.1, but may work for other versions as well. It was tested using kernel 2.6.16, but may work for other versions as well.

SUSE follows the general procedures for compiling but needs this in the ./configure command:

--with-jsapi-include=/usr/include/js

Be sure to install ALL developer RPMs (packagename-devel) of the libraries you want to use, specially spider monkey.

For 64-bit users, before you try to compile, you need to run to this command first:

 export LDFLAGS="-L/usr/X11R6/lib64"

Microsoft Windows

This is a guide to building Avidemux from SVN in Microsoft Windows. It is intended for people who are familiar with compiling software but not necessarily using MinGW.

Prerequisites

Mandatory

• Archive utility that supports GZ, JAR, TAR and ZIP formats, e.g. WinZip
• 500MB free disk space (MSYS – 50MB, MinGW – 135MB, Avidemux – 315MB)

Optional

• Microsoft Visual C++ 6.0 with Service Pack 5

Build Environment

Download Components

These components are necessary to build Avidemux on Microsoft Windows.

These components are only required if you wish to compile optional dependencies.

These components are only required if you wish to compile optional dependencies with Microsoft Visual C++.

Install Build Environment

To build Avidemux on a Microsoft Windows operating system you will require MSYS and MinGW. MSYS is a Unix style shell environment for Windows. MinGW is a collection of header files, import libraries and GNU toolsets for producing native Windows programs.

To download the Avidemux source code you will require TortoiseSVN, which is source control software. It is implemented as a Windows shell extension, which makes it integrate seamlessly into the Windows explorer.

MinGW

1. Extract the contents of each MinGW tarball (binutils, gcc-core, gcc-g++, mingw-runtime, mingw-utils, w32api) to a folder on your hard-drive, e.g. C:\Dev\MinGW.

MSYS

1. Run the MSYS installer (e.g. MSYS-1.0.11-2004.04.30-1.exe) and follow the install wizard. Choose an appropriate destination folder, e.g. C:\Dev\msys.
2. Agree to the post install process.
3. State that MinGW is installed.
4. Enter the MinGW installation folder.
5. Run the MSYS Developer Toolkit installer (e.g. msysDTK-1.0.1.exe) and follow the install wizard. Choose the MSYS folder for the destination folder.

Pkg-config

1. Extract the contents of the Pkg-config zip file to the MinGW folder.

TortoiseSVN

1. Run the Tortoise SVN installer and follow the install wizard.

Install Optional Build Environment

Microsoft Visual C++ 6 Processor Pack

Install the Processor Pack only if you wish to compile optional dependencies using Microsoft Visual C++.

1. Run the Processor Pack installer and follow the install wizard.

Netwide Assembler

1. Extract the contents of the NASM zip file to an appropriate folder, e.g. C:\Program Files\Nasm.
2. Make a copy of nasmw.exe and rename it to nasm.exe in the Nasm folder. (The optional components expect the filename to be nasm.exe but the Win32 version of NASM has a filename of nasmw.exe)
3. Copy nasm.exe to the MinGW bin folder.

Configure Build Environment

If you’ve installed the Netwide Assembler and wish to use Microsoft Visual C++ to compile optional dependencies, also follow these steps:

1. Start Microsoft Visual C++.
2. Choose Options from the Tools menu.
3. Choose the Directories tab.
4. Select Executable Files from the Show Directories For dropdown box.
5. Add the path for NASM, e.g. C:\Program Files\Nasm.

Downloading Source Code from SVN

The source code for Avidemux and some of its dependencies must be downloaded from subversion repositories. TortoiseSVN supports all subversion protocols. Follow these steps to download code from an SVN URL:

1. Open Windows Explorer and click on the C: drive with the right mouse button.
2. Choose SVN Checkout from the popup menu.
3. Enter the URL of repository, e.g. svn://svn.berlios.de/avidemux/branches/avidemux_2.3_branch/.
4. Enter a Checkout directory, e.g. c:\Dev\avidemux.
5. Click OK to download the source code.

Avidemux Dependencies

Download Dependencies

These dependencies are necessary to successfully build Avidemux.

These libraries are optional but enable Avidemux to have greater functionality.

Install Dependencies

Expat

1. Extract the files xmlparse.dll and xmltok.dll from the expat zip file to the MinGW bin folder.
2. Copy xmlparse.dll as libexpat.dll.

GTK+

1. Extract the contents of each zip file (atk, atk-dev, cairo, cairo-dev, fontconfig, fontconfig-dev, freetype, freetype-lib, gettext, gettext-dev, glib, glib-dev, gtk+, gtk+-dev, libiconv, libpng, libpng-lib, pango, pango-dev) to the MinGW folder.

Libxml2

1. Extract the contents of the libxml2 zip file to a temporary folder.
2. Move the libxml2 bin, include and lib folders to the corresponding MinGW folders.

Netscape Portable Runtime

1. Extract the contents of the nspr zip file to a folder, e.g. C:\Dev.
2. Copy libnspr4.dll from the NSPR lib folder to the MinGW bin folder.

Pthreads-w32 v1

1. Run the Pthreads-w32 exe to extract required files to a temporary folder.
2. Copy the contents of the Pre-built.1\include folder to the MinGW include folder.
3. Copy all a and lib files from the Pre-built.1\lib folder to the MinGW lib folder.
4. Copy all dll files from the Pre-built.1\lib folder to the MinGW bin folder.

Zlib

1. Extract the contents of the zlib zip file to the MinGW folder.
2. Copy zdll.lib in the MinGW lib folder as z.lib.
3. Move zlib1.dll from the MinGW folder to the MinGW bin folder.

Spidermonkey

1. Extract the contents of the tarball to a folder, e.g. C:\Dev.
2. Build Spidermonkey using Microsoft Visual C++ or MinGW:

# Project: fdlibm

CC = gcc.exe
SRCDIR = /c/dev/js/src/fdlibm

OBJECTS= \
$(SRCDIR)/w_sqrt.o \
$(SRCDIR)/e_pow.o \
$(SRCDIR)/e_sqrt.o \
$(SRCDIR)/k_standard.o \
$(SRCDIR)/s_atan.o \
$(SRCDIR)/s_finite.o \
$(SRCDIR)/s_isnan.o \
$(SRCDIR)/s_matherr.o \
$(SRCDIR)/s_rint.o \
$(SRCDIR)/s_scalbn.o \
$(SRCDIR)/w_atan2.o \
$(SRCDIR)/e_atan2.o \
$(SRCDIR)/s_fabs.o \
$(SRCDIR)/s_copysign.o \
$(SRCDIR)/w_pow.o \
$(SRCDIR)/s_lib_version.o

LIBS = -llibm
BIN  = fdlibm.lib
CFLAGS = -DJS_THREADSAFE -D_IEEE_LIBM -DWIN32 -D_WINDOWS -s
.c.o: $(CC) -c $(CFLAGS) -o $@ $*.c

$(BIN): $(OBJECTS)
	ar r $(BIN) $(OBJECTS)
	ranlib $(BIN)

# Project: js32

CC   = gcc.exe
WINDRES = windres.exe
RES  = js.res
SRCDIR = /c/dev/js/src
OBJECTS = \
    $(SRCDIR)/jsapi.o \
    $(SRCDIR)/jsarena.o \
    $(SRCDIR)/jsarray.o \
    $(SRCDIR)/jsatom.o \
    $(SRCDIR)/jsbool.o \
    $(SRCDIR)/jscntxt.o \
    $(SRCDIR)/jsdate.o \
    $(SRCDIR)/jsdbgapi.o \
    $(SRCDIR)/jsdhash.o \
    $(SRCDIR)/jsdtoa.o \
    $(SRCDIR)/jsemit.o \
    $(SRCDIR)/jsexn.o \
    $(SRCDIR)/jsfun.o \
    $(SRCDIR)/jsgc.o \
    $(SRCDIR)/jshash.o \
    $(SRCDIR)/jsinterp.o \
    $(SRCDIR)/jslock.o \
    $(SRCDIR)/jslog2.o \
    $(SRCDIR)/jslong.o \
    $(SRCDIR)/jsmath.o \
    $(SRCDIR)/jsnum.o \
    $(SRCDIR)/jsobj.o \
    $(SRCDIR)/jsopcode.o \
    $(SRCDIR)/jsparse.o \
    $(SRCDIR)/jsprf.o \
    $(SRCDIR)/jsregexp.o \
    $(SRCDIR)/jsscan.o \
    $(SRCDIR)/jsscope.o \
    $(SRCDIR)/jsscript.o \
    $(SRCDIR)/jsstr.o \
    $(SRCDIR)/jsutil.o \
    $(SRCDIR)/jsxdrapi.o \
    $(SRCDIR)/prmjtime.o \
    $(RES)

LIBS =  --add-stdcall-alias -lfdlibm -lnspr4 -L./fdlibm -L/c/dev/nspr-4.4.1/lib
BIN  = js.dll
CFLAGS = -I/dev/nspr-4.4.1/include -DJS_THREADSAFE -DXP_WIN \
-DEXPORT_JS_API -D_WINDOWS -DWIN32 -D_MINGW -s

DLLWRAP=dllwrap.exe
DEFFILE=libjs.def
STATICLIB=libjs.a
.c.o: $(CC) -c $(CFLAGS) -o $@ $*.c

$(BIN): $(OBJECTS)
	$(CC) -shared -o $@ \
	-Wl,--output-def,$(DEFFILE) \
	-Wl,--out-implib,$(STATICLIB) \
	$(OBJECTS) \
	$(LIBS)

$(RES): 
	$(WINDRES) -i $(SRCDIR)/js3240.rc -I rc -o $(RES) -O coff

Install Optional Libraries

Aften

If you prefer to use a DLL rather than linking to a static library, also follow these steps:

FAAC

FAAD

LIBRARY  libfaad2.dll
EXPORTS
;
; libfaad exports
;
NeAACDecOpen                      @1
NeAACDecGetCurrentConfiguration   @2
NeAACDecSetConfiguration          @3
NeAACDecInit                      @4
NeAACDecInit2                     @5
NeAACDecDecode                    @6
NeAACDecClose                     @7
NeAACDecGetErrorMessage           @8
NeAACDecAudioSpecificConfig       @9
NeAACDecPostSeekReset             @10

LAME

Libdca

If you prefer to use a DLL rather than linking to a static library, also follow these steps:

Ogg Vorbis

Simple DirectMedia Layer

x264

if cc_check pthread.h -lpthread "pthread_create(0,0,0,0);" ; then
      pthread="yes"
      libpthread="-lpthread"

if cc_check pthread.h –lpthreadGC1 "pthread_create(0,0,0,0);" ; then
      pthread="yes"
      libpthread="-lpthreadGC1"

libx264.a: .depend $(OBJS) $(OBJASM)
	ar rc libx264.a $(OBJS) $(OBJASM)
	ranlib libx264.a

$(SONAME): .depend $(OBJS) $(OBJASM)
	$(CC) -shared -o $@ $(OBJS) $(OBJASM) -Wl,-soname,$(SONAME) $(LDFLAGS)

ifeq ($(SYS),MINGW)
	$(CC) -shared -Wl,--out-implib,libx264.a -o libx264.dll $(OBJS) $(OBJASM) $(LDFLAGS)
else
	libx264.a: .depend $(OBJS) $(OBJASM)
		ar rc libx264.a $(OBJS) $(OBJASM)
		ranlib libx264.a

	$(SONAME): .depend $(OBJS) $(OBJASM)
		$(CC) -shared -o $@ $(OBJS) $(OBJASM) -Wl,-soname,$(SONAME) $(LDFLAGS)
endif

Xvid

Build Avidemux

/bin/sh ../libtool --silent --mode=link g++ -g -I.. -I../ADM_lavutil -IADM_library -I../ADM_library  \
-D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -g -O2 -mno-cygwin -mms-bitfields -O2 -falign-loops=16  \
-o avidemux2.exe   \
-L/mingw/lib \
\
guiplay.o gui_savenew.o gui_navigate.o gtk_gui.o callbacks.o \
avilist.o main.o prefs.o ADM_guiBitrate.o ADM_pp.o ADM_memsupport.o \
gui_autodrive.o GUI_jobs.o ADM_dialog/DIA_quota.o \
ADM_lavcodec/libavcodec.a ADM_lavcodec/libpostproc/libpostproc.a \
./ADM_script/libADM_script.a ./ADM_editor/libADM_editor.a \
./ADM_library/libADM_library.a ./ADM_openDML/libADM_openDML.a \
./oplug_ogm/liboplug_ogm.a ./ADM_audiocodec/libADM_audiocodec.a \
./ADM_audio/libADM_audio.a ./oplug_avi/liboplug_avi.a \
./oplug_mp4/liboplug_mp4.a ./oplug_mpeg/liboplug_mpeg.a \
./oplug_mpegFF/liboplug_mpegFF.a ./ADM_mplex/libADM_mplex.a \
./ADM_lavformat/libADM_lavformat.a ./ADM_lavutil/libADM_lavutil.a \
./ADM_lvemux/libADM_lvemux.a ./ADM_filter/libADM_filter.a \
./ADM_video/libADM_video.a   ./ADM_encoder/libADM_encoder.a \
./ADM_codecs/libADM_codecs.a ./ADM_vp32/libADM_vp32.a \
./ADM_audiofilter/libADM_audiofilter.a ./libtoolame/liblibtoolame.a \
./ADM_gui2/libADM_gui2.a ./ADM_libswscale/libswscale.a \
./mpeg2enc/libmpeg2enc.a ./ADM_liba52/libADM_liba52.a \
./ADM_libMad/libADM_mad.a ./ADM_inpics/libADM_inpics.a  \
./ADM_3gp/libADM_3gp.a ./ADM_avsproxy/libADM_avsproxy.a \
./ADM_matroska/libADM_matroska.a ./ADM_asf/libADM_asf.a \
./ADM_h263/libADM_h263.a ./ADM_nuv/libADM_nuv.a \
./ADM_ogm/libADM_ogm.a ./ADM_audiodevice/libADM_audiodevice.a \
./ADM_xvidratectl/libADM_xvidratectl.a ./ADM_requant/libADM_requant.a \
./ADM_ocr/libADM_ocr.a ./ADM_mpegdemuxer/libADM_mpegdemuxer.a \
./ADM_audio/libADM_audio.a ./ADM_toolkit/libADM_toolkit.a \
./ADM_dialog/libADM_dialog.a ./libMpeg2Dec/liblibMpeg2Dec.a \
./ADM_tray/libADM_tray.a ./ADM_colorspace/libADM_colorspace.a \
ADM_lavcodec/libavcodec.a ./ADM_lavutil/libADM_lavutil.a \
./ADM_lavcodec/libpostproc/libpostproc.a ./ADM_library/libADM_library.a \
./ADM_toolkit/libADM_toolkit.a ./libass/libass.a   \
./xpm/adm.o \
\
-luuid -ljs -lfontconfig -lmp3lame -lvorbis -lvorbisenc -lfaac -lfaad \
-ldts -lxvidcore -lpng -lx264 -laften -lmingw32 -lSDLmain -lSDL \
-mwindows -user32 -lpthreadGC1 -lgtk-win32-2.0 -lgdk-win32-2.0 -limm32 \
-lshell32 -lole32 -latk-1.0 -lgdk_pixbuf-2.0 -lpangowin32-1.0 -lgdi32 \
-lpangocairo-1.0 -lpango-1.0 -lcairo -lgobject-2.0 -lgmodule-2.0 \
-lglib-2.0 -lintl -liconv -lgthread-2.0 -lfreetype -lz -llibxml2 \
-lwinmm -lwsock32