Files
veejay/veejay-current/veejay-server/doc/Installation.md
2025-11-02 17:15:25 +01:00

4.3 KiB

Get all the dependencies

First, make sure you system is up-to-date, and install (in debian like system) the required dependencies with:

$ sudo apt-get install build-essential autoconf automake libtool m4 gcc libjpeg62-dev \
libswscale-dev libavutil-dev libavcodec-dev libavformat-dev libx11-dev  \
gtk-3.0-dev libxml2-dev libsdl2-dev libjack0 libjack-dev jackd1

Please note that on some debian like systems, package names for gtk may vary. If gtk-3.0-dev is missing, try libgtk-3-dev

Build the veejay's applications

Veejay is divided into multiple packages. Each must be build separately and in a specific order.

  1. veejay-core (required)
  2. veejay-server (required)
  3. veejay-client (optional)
  4. veejay-utils (optional)
  5. plugin-packs (optional)

For each package, run the triptich commands of the GNU build system (for a quick start you can build the first two):

$ ./autogen.sh
$ ./configure
$ make -j$(nproc) && sudo make install

IMPORTANT : in some configuration you should have to manually build the shared libraries cache just after the first veejay-core installation (ex sudo ldconfig or similar)

Configure : You do not need to pass any parameters to ./configure for veejay to be optimized with the current cpu-type. If you want help to build for a specific architecture or with or without particular options (ex jack sound support) ... take a look to the ./configure --help to adapt to many kinds of systems.

Before running veejay, be sure to add or link some TrueType fonts in $HOME/.veejay/fonts

Additional information about building and configuring veejay packages can be found in HOWTO.compile.md

Usage

Running veejay is a much too large topic to cover in this readme. Various pointers have been bundled with the sources in veejay/veejay-current/veejay-server/doc

Articles covering various aspects of "how to veejay" can be found on veejayhq.net

But the quick answer would be:

1. Start one or more Veejay servers:

$ veejay --clip-as-sample my-movie-A.avi
$ veejay -p 4490 -g my-movie-B.avi

2. Start and autoconnect the veejay graphical interface:

$ reloaded -a

Building and Configuring plugins

Veejay contain more than 160 built-in FX, many unique and original FX filters.
But you can have more !

frei0r

Veejay looks in a few common locations to find the frei0r plugins pack:

  • /usr/local/lib/frei0r-1
  • /usr/lib/frei0r-1
  • /usr/lib64/frei0r-1

You can list more location in the file $HOME/.veejay/plugins.cfg

plugin-packs

There are several plugin-packs available for veejay: plugin-packs

  • lvdcrop ; a couple of crop filters and a port of frei0r's scale0tilt
  • lvdshared ; a couple of plugins that implement a producer/consumer mechanism for shared video resources
  • lvdgmic ; GMIC based filters, although slow in processing they are quite amazing
  • lvdasciiart ; let's do ascii ! ported from ffmpeg ASCII filter writen by Alexander Tumin

To compile and install a plugin-pack:

$ cd plugin-packs/lvdgmic
$ ./autogen.sh
$ ./configure
$ make && sudo make install

Default parameter values

You can change the default FX parameter values by editing the files in $HOME/.veejay/frei0r/ and $HOME/.veejay/livido/

See Also : For more verbose information about plugins and FX check How to Plugins

Debugging

If you want to debug veejay-server (or if you want to submit a meaningful backtrace), build with:

./configure --enable-debug

see also : How to debug