LiVES  3.2.0
About: LiVES is a Video Editing System (and a VJ tool). It mixes realtime video performance and non-linear editing in one application.
  Fossies Dox: LiVES-3.2.0.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

LiVES Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies LiVES-3.2.0.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
LiVES is a Video Editing System
-     -    -     -       -

Original author: salsaman ( and others (see file AUTHORS)

Released under the GNU PUBLIC LICENSE, version 3 or later.
See file COPYING in this directory for licensing details

You should read these installation instructions thoroughly before installing 


1) Mandatory dependencies include *at least*:
GTK+ (>=3.0.0) + development libs [preferred]
or GTK+ (>=2.16) + development libs
gdk-pixbuf-loaders + development libs
gettext + development libs

mplayer or mplayer2 (preferred) [or mpv] with jpeg/png output support
ffmpeg with jpeg/png input support (preferably with x264 support)
sox (*with* libsox-fmt-all if applicable !)

2) *Highly* Recommended build-dependencies include (devel versions of):
libpulse, libjack, ffmpeg, mjpegtools, libogg, libtheora, libdv,
libraw1394, libavc1394, libunicap, ( libavcodec, libavformat,
libavutils, libswscale, ) or ( ffmpeg-libs), libpng, libasound2, libX11,
libXrender, libGL, GLee, libfftwf3.

(For compiling you should have development versions of these libraries
installed. Check the output of ./configure *carefully* for missing
optional dependencies.)

*Optional*: openCV, LADSPA headers.frei0r-devel, libvisual, libSDL1.2, projectM.

3) *Highly* Recommended runtime dependencies include:
python, libtheora-bin, mkvtoolnix, vorbis-tools,
libmatroska, ogmtools, dvgrab, frei0r-plugins,
libdv2-apps/libdv-bin, cdda2wav/icedax, lame, ffmpeg, x264, youtube-dl, LADSPA plugins.

EXAMPLE: Ubuntu 16.04 Packages

CORE (recommended packages):

Build deps:
autotools-dev autoconf autopoint libtool libgtk-3-dev libpulse-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev glee-dev libglu1-mesa-dev libogg-dev libtheora-dev libtheora-bin libvorbis-dev libunicap2-dev libfftw3-dev libmjpegtools-dev libavc1394-dev libdv4-dev libbz2-dev

Runtime deps:
perl python mplayer2 sox imagemagick ffmpeg libgtk-3 libav-tools-links libpulse libavcodec libavformat libavutil libswscale libglee libglu1-mesa libogg libtheora libtheora-bin libvorbis libunicap2 libfftw3 libmjpegtools libavc1394 libdv4 libbz2 jackd dvgrab icedax youtube-dl

Extra effects:

Build deps:
libopencv-dev ladspa-sdk frei0r-plugins-dev libvisual-0.4-dev libsdl1.2-dev libprojectm-dev projectm-data

Runtime deps:
libopencv ladspa-sdk frei0r-plugins libvisual-0.4 libprojectm2v5 projectm-data libsdl1.2

Extra encoders:

Build deps:
libmatroska-dev libschroedinger-dev

Runtime deps:
libmatroska libschroedinger ogmtools mkvtoolnix vorbis-tools lame x264 gpac mencoder

Installation (git version)

See the LiVES website:

Installation (binary versions)
See the LiVES website:
for more information.

If you got LiVES as a tar.gz or tar.bz2, at a terminal prompt, enter the following:

          bzip2 -d LiVES-3.2.0.tar.bz2
          gzip -d LiVES-3.2.0.tar.gz

depending on which version you have. Then:

          tar xvf LIVES-3.2.0.tar

          cd lives-3.2.0

now type:

check the output of configure very carefully, following any advice it provides, 
and making any adjustments you may wish - such as installing optional libraries.

If you are happy with the output from configure, then compile the source with:


again, check the output for any warnings or errors.

Assuming everything went OK, you can now install the application with:

	make install

(you probably need to do this as root - on some systems you would become root using "su", on other systems you would run

	sudo make install


Finally, you should make sure your system can find the new libraries installed by LiVES:

	sudo ldconfig

You can then run lives either from a menu, or by typing in a terminal:


The default location for everything is inside /usr; so executables go in /usr/bin, themes and scripts in /usr/share/lives/, and libraries and compiled plugins in /usr/lib.

  When installing from source, you can change this with:
        ./configure --prefix=/some/other/dir

  You can also install in a non-default directory with:
	make install DESTDIR=/some/other/dir

However, if you do relocate, and this is not a fresh install, you will need to edit your .lives file in your home directory and adjust <prefix_dir> and <lib_dir>
so that they point to the correct locations for scripts and plugins.

IMPORTANT: if the library directory is anything except /usr/lib, you should adjust the libraries in libweed pkg-config files:
libweed/*.pc. If you use a library path other $PREFIX/lib for the plugins you also need to do:

./configure --libdir=<path_to_lib>
e.g. ./configure --libdir=/usr/lib/libx86_64-linux-gnu/

Other configuration options

For a complete list of configure options, type:

	./configure --help

Make sure you have themes and icons, and plugins installed as above.
If they are moved from their installed location, make sure you edit <prefix_dir> and <lib_dir>
in ~/.lives

In case of any problems, check your ~/.lives file and make sure everything is 
pointing to the right locations.

You can also try deleting your ~/.lives file. LiVES will then run through the install process the next time it is started.

Make sure there is plenty of space available in the working directory. The directory may be changed through Preferences / Directories.

Run through Help -> Troubleshoot in the app and see if anything is missing.

If you are having problems encoding, make sure you have everything you need 
installed. The plugins are just interfaces, and you need to have the binaries 
installed also. Some of the encoder formats have other dependencies, the LiVES website has more details.

Problems opening files
If you have problems opening a particular video file, try to preview
it first in the 'open file' dialogue. If you cannot preview it, it means mplayer is not 
compiled to open it. You may need to recompile mplayer for your system
with extra libraries.

Note that current versions of LiVES no longer require mplayer to open most file types. Make sure you have the necessary libraries compiled in libav. For other formats, dv format can be opened with libdv and the dv_decoder plugin. Ogg/theora can be opened with libogg and libtheora.

If you are having problems opening video, edit /usr/bin/smogrify, and near the top put:
you will then see the mplayer open command on the console, which can
be cut and pasted into a terminal window.

Finally, if you are still having problems, join the lives-video
mailing list and you can ask your question there !

Implemented functions - technical
Visit the LiVES website (

The 'load audio' function supports .wav, .mp3 (mpg123 required), mod, xm and
.ogg (ogg123 required).


See the file BUGS.