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)
transcode (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.8.1-1.i586.rpm

If you see the message:

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

and you have mplayer installed and you built it from source, you can safely ignore this. This dependancy is just there as a reminder.


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







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

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

then:

        cd LiVES-0.8.1

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.8.1/lives-exe /usr/bin
       chmod a+x /usr/bin/lives-exe
       ln -s /usr/bin/lives-exe /usr/bin/lives

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


and then run lives:

       lives







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.8.1-src.tar.bz2
or,
          gzip -d LiVES-0.8.1-src.tar.gz

depending on which version you have. Then:


          tar xvf LiVES-0.8.1-src.tar

          cd LiVES-0.8.1

          ./configure && make install

	  ln -s /usr/bin/lives-exe /usr/bin/lives

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.8.1.tar.gz /usr/share/lives/
	  tar -xvf /usr/share/lives/lives-themes-0.8.1.tar.gz

Then start the binary with:
 

        lives



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.
