1LiVES 2----- 3LiVES is a Video Editing System 4- - - - - 5 6 7Original author: salsaman (salsaman+lives@gmail.com) and others (see file AUTHORS) 8 9 10Released under the GNU PUBLIC LICENSE, version 3 or later. 11See file COPYING in this directory for licensing details 12 13 14You should read these installation instructions thoroughly before installing 15LiVES. 16 17 18DEPENDENCIES 19------------ 20 211) Mandatory dependencies include *at least*: 22Build 23----- 24GTK+ (>=3.0.0) + development libs [preferred] 25or GTK+ (>=2.16) + development libs 26gdk-pixbuf-loaders + development libs 27gettext + development libs 28 29Runtime 30------- 31mplayer or mplayer2 (preferred) [or mpv] with jpeg/png output support 32ffmpeg with jpeg/png input support (preferably with x264 support) 33imageMagick 34perl 35sox (*with* libsox-fmt-all if applicable !) 36 37 38 392) *Highly* Recommended build-dependencies include (devel versions of): 40libpulse, libjack, ffmpeg, mjpegtools, libogg, libtheora, libdv, 41libraw1394, libavc1394, libunicap, ( libavcodec, libavformat, 42libavutils, libswscale, ) or ( ffmpeg-libs), libpng, libasound2, libX11, 43libXrender, libGL, GLee, libfftwf3. 44 45(For compiling you should have development versions of these libraries 46installed. Check the output of ./configure *carefully* for missing 47optional dependencies.) 48 49*Optional*: openCV, LADSPA headers.frei0r-devel, libvisual, libSDL1.2, projectM. 50 51 523) *Highly* Recommended runtime dependencies include: 53python, libtheora-bin, mkvtoolnix, vorbis-tools, 54libmatroska, ogmtools, dvgrab, frei0r-plugins, 55libdv2-apps/libdv-bin, cdda2wav/icedax, lame, ffmpeg, x264, youtube-dl, LADSPA plugins. 56 57 58 59EXAMPLE: Ubuntu 16.04 Packages 60 61 62 63CORE (recommended packages): 64 65Build deps: 66autotools-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 67 68Runtime deps: 69perl 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 70 71 72 73 74Extra effects: 75 76Build deps: 77libopencv-dev ladspa-sdk frei0r-plugins-dev libvisual-0.4-dev libsdl1.2-dev libprojectm-dev projectm-data 78 79Runtime deps: 80libopencv ladspa-sdk frei0r-plugins libvisual-0.4 libprojectm2v5 projectm-data libsdl1.2 81 82 83 84 85 86Extra encoders: 87 88Build deps: 89libmatroska-dev libschroedinger-dev 90 91 92Runtime deps: 93libmatroska libschroedinger ogmtools mkvtoolnix vorbis-tools lame x264 gpac mencoder 94 95 96 97Installation (git version) 98------------------------- 99 100See the LiVES website: http://lives-video.com/index.php?do=code 101 102 103 104 105 106Installation (binary versions) 107_________________ 108See the LiVES website: 109http://lives-video.com/index.php?do=downloads 110for more information. 111 112 113 114 115 116INSTALLING FROM SOURCE 117---------------------------------------------------- 118If you got LiVES as a tar.gz or tar.bz2, at a terminal prompt, enter the following: 119 120 121 bzip2 -d LiVES-3.2.0.tar.bz2 122or, 123 gzip -d LiVES-3.2.0.tar.gz 124 125depending on which version you have. Then: 126 127 128 tar xvf LIVES-3.2.0.tar 129 130 cd lives-3.2.0 131 132 133 134now type: 135 ./configure 136 137check the output of configure very carefully, following any advice it provides, 138and making any adjustments you may wish - such as installing optional libraries. 139 140If you are happy with the output from configure, then compile the source with: 141 142 make 143 144 145again, check the output for any warnings or errors. 146 147 148Assuming everything went OK, you can now install the application with: 149 150 make install 151 152(you probably need to do this as root - on some systems you would become root using "su", on other systems you would run 153 154 sudo make install 155 156) 157 158 159Finally, you should make sure your system can find the new libraries installed by LiVES: 160 161 sudo ldconfig 162 163 164 165 166 167 168You can then run lives either from a menu, or by typing in a terminal: 169 170 171 lives 172 173 174 175 176 177 178 179 180Relocating: 181----------- 182The 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. 183 184 185 When installing from source, you can change this with: 186 ./configure --prefix=/some/other/dir 187 188 189 You can also install in a non-default directory with: 190 make install DESTDIR=/some/other/dir 191 192 193 194However, 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> 195so that they point to the correct locations for scripts and plugins. 196 197IMPORTANT: if the library directory is anything except /usr/lib, you should adjust the libraries in libweed pkg-config files: 198libweed/*.pc. If you use a library path other $PREFIX/lib for the plugins you also need to do: 199 200./configure --libdir=<path_to_lib> 201e.g. ./configure --libdir=/usr/lib/libx86_64-linux-gnu/ 202 203 204 205 206 207 208Other configuration options 209--------------------------- 210 211For a complete list of configure options, type: 212 213 ./configure --help 214 215 216 217 218Troubleshooting 219--------------- 220Make sure you have themes and icons, and plugins installed as above. 221If they are moved from their installed location, make sure you edit <prefix_dir> and <lib_dir> 222in ~/.lives 223 224In case of any problems, check your ~/.lives file and make sure everything is 225pointing to the right locations. 226 227You can also try deleting your ~/.lives file. LiVES will then run through the install process the next time it is started. 228 229 230Make sure there is plenty of space available in the working directory. The directory may be changed through Preferences / Directories. 231 232 233Run through Help -> Troubleshoot in the app and see if anything is missing. 234 235 236If you are having problems encoding, make sure you have everything you need 237installed. The plugins are just interfaces, and you need to have the binaries 238installed also. Some of the encoder formats have other dependencies, the LiVES website has more details. 239 240 241 242 243Problems opening files 244---------------------- 245If you have problems opening a particular video file, try to preview 246it first in the 'open file' dialogue. If you cannot preview it, it means mplayer is not 247compiled to open it. You may need to recompile mplayer for your system 248with extra libraries. 249 250Note 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. 251 252 253 254If you are having problems opening video, edit /usr/bin/smogrify, and near the top put: 255$DEBUG_OPEN=1; 256you will then see the mplayer open command on the console, which can 257be cut and pasted into a terminal window. 258 259Finally, if you are still having problems, join the lives-video 260mailing list and you can ask your question there ! 261 262 263Implemented functions - technical 264--------------------------------- 265Visit the LiVES website (http://lives-video.com/index.php?do=features). 266 267 268Notes 269----- 270The 'load audio' function supports .wav, .mp3 (mpg123 required), mod, xm and 271.ogg (ogg123 required). 272 273 274 275 276 277KNOWN BUGS 278---------- 279 280 281See the file BUGS. 282 283