LiVES
-----
LiVES is a Video Editing System
-     -    -     -       -


Original author: salsaman (salsaman@xs4all.nl)


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


You should read these installation instructions thoroughly before installing 
LiVES.



Requirements
-------------------
Linux 2.x or BSD or openMosix or IRIX or OSX/Darwin (other UNIX untested)


mplayer 0.90rc1+ compiled with jpeg support
ImageMagick 5
perl 5+
gtk+ 2.8+
libjpeg62
gdk-pixbuf-loaders

sox (recommended)
transcode (recommended)
mencoder (recommended)
libmjpeg-tools (recommended)

xmms (optional)
cdda2wav (optional)




Installation (CVS)
------------------

See the LiVES website: http://lives.sourceforge.net/index.php?do=cvs





Installation (binary versions)
_________________
See the LiVES website:
http://lives.sourceforge.net/index.php?do=downloads
for more information.





Installing from source (Dev/pre/CVS versions)
---------------------------------------------
If you got LiVES as a tar.gz or tar.bz2, at a terminal prompt, enter the following:


          bzip2 -d LiVES-0.9.8.5.tar.bz2
or,
          gzip -d LiVES-0.9.8.5.tar.gz

depending on which version you have. Then:


          tar xvf LIVES-0.9.8.5.tar

          cd lives

for CVS checkouts, this is not necessary.

now type:
	./configure && make install

the default location for everything is inside /usr; so executables go in /usr/bin, themes/plugins in /usr/share/lives/

If you want to select an alternate install location, you can do:
	./configure --prefix=/usr/local && make install
for example. 

Note:
LiVES should autodetect the plugin location, now there is no need to change <prefix_dir> in ~/.lives.
Users of older versions who upgrade may still need to adjust this setting if older plugins were installed in 
a different location.

Now start LiVES with:




 
        lives
or:
        lives-exe






Relocating:
-----------
As noted above, the default location for binaries, plugins, themes and icons is /usr.

  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




Other configure options
-----------------------
If you use ./configure --enable-OSC
LiVES will be built with OSC support enabled.
You can then change the OSC settings through Preferences|Streaming/Networking after installing/running LiVES.
See the document lives-OMC.txt for more information on this.



Troubleshooting
---------------
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>
in ~/.lives

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

Make sure there is plenty of space available in the temporary directory
(default is /tmp/livestmp).
It is advisable to change the temp directory from Tools|Preferences|Directory.

Make sure you have a working copy of mplayer installed, and that it is 
compiled with jpeg support.

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, you may need to check online.


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.

If you are having problems opening video, edit /usr/bin/smogrify, and near the top put:
$DEBUG_OPEN=1;
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 !



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

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

The same is true for .desktop entries. You will need to use:
Terminal=yes
Geometry=0x0
 





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




Implemented functions - technical
---------------------------------
Visit the LiVES website (http://lives.sourceforge.net/index.php?do=features).


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





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


See the file BUGS.

