LiVES
-----
The Linux* Video Editing System
    --    -     -       -

Author: salsaman (salsaman@xs4all.nl)


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




Requirements
-------------------

mplayer 0.90rc1+
mencoder with libavcodec  (required for saving only)
ImageMagick 5
perl 5+
gtk+ 2.x
libjpeg62
gdk-pixbuf-loaders

sox (recommended)

xmms (optional)
cdda2wav (optional)





Installation (RPM)
_________________

If necessary, change user to root. Type:

           su -

and enter the root password.



Then:
          rpm -Uvh LiVES-0.7.5-1.i586.rpm

If you see the message:

"error: failed dependencies:
        mplayer >= 0.90rc1 is needed by LiVES-0.7.5-1"

and you have mplayer installed, you can safely ignore this, since there are no 
rpms of mplayer. This dependancy is just there as a reminder.


If there are no other failed dependencies, it is safe to do:
           rpm -Uvh LiVES-0.7.5-1.i586.rpm --nodeps







Installation (Binary version)
----------------------------
First of all, unpack the distribution, with:

        bzip2 -d LiVES-0.7.5-bin.tar.bz2
        tar xvf LiVES-0.7.5-bin.tar

then:

        cd LiVES-0.7.5

Next, make sure that smogrify and lives are in your path, e.g:

       cp smogrify /usr/bin
       chmod a+x /usr/bin/smogrify
       cp LiVES-0.7.5/lives-exe /usr/bin
       chmod a+x /usr/bin/lives-exe

(you will probably need to be root to do that)


and then run lives-exe:

       lives-exe







Troubleshooting
---------------
For best results start with a SMALL ( <50MB ) video file.

Make sure there is plenty of space available in the temporary directory
(default is /tmp/livestmp).

You can change this from Tools|Preferences|Directory.



IMPORTANT !
-----------
When started from a desktop icon, or from a menu, LiVES can sometimes cause 
strange effects in X11.

To prevent this, LiVES should always be started from a terminal, so if there is an
 option to do this, it should be selected. If there are terminal options, you 
may enter '-geometry 0x0' to prevent the terminal from actually appearing.





 






Installing from source
----------------------
At a terminal prompt, enter the following:


          bzip2 -d LiVES-0.7.5-src.tar.bz2
or,
          gzip -d LiVES-0.7.5-src.tar.gz

depending on which version you have. Then:


          tar xvf LiVES-0.7.5-src.tar

          cd LiVES-0.7.5

          ./configure && make install

Now you need to install the plugins:
          mkdirhier /usr/share/lives/plugins/encoders/
	  cp lives-encoder-plugins.tar /usr/share/lives/plugins/
	  tar -xvf /usr/share/lives/plugins/lives-encoder-plugins.tar
	  chmod -R a+x /usr/share/lives/plugins/

Themes are installed in a similar way in the themes directory:

	  mkdirhier /usr/share/lives/themes/
	  mv lives-themes-0.7.5.tar.gz /usr/share/lives/
	  tar -xvf /usr/share/lives/lives-themes-0.7.5.tar.gz

Then start the binary with:
 

        lives-exe



Implemented features
--------------------
See the file FEATURES.





Implemented functions - technical
---------------------------------
See LiVES.html or visit the LiVES website (http://www.xs4all.nl/~salsaman/lives/).


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





KNOWN BUGS
----------


See the file BUGS.