Files
veejay/veejay-current/veejay-server
2025-11-03 20:30:45 +01:00
..
2018-12-27 20:21:47 +01:00
2025-11-02 17:15:25 +01:00
2023-09-25 01:38:40 +02:00
2023-10-27 10:23:56 +02:00
2025-11-03 01:45:09 +01:00
2023-09-03 23:42:33 +02:00
2023-11-10 23:09:58 +01:00
2025-11-02 21:44:04 +01:00
2023-10-25 20:54:50 +02:00
2023-09-28 02:58:43 +02:00
2025-11-03 02:59:10 +01:00
2016-02-09 15:49:50 +01:00




    10x0            0x     x10x0x10x0x10x   10x0x10x0x10x0        x0x1         x0x1       10x0        x0x1
  0x10x0            0x0x   x10x0x10x0x10x   10x0x10x0x10x0        x0x1       10x0x10x      10x0x1    10x0x1
0x0x10              0x0x10 x10x             10x0                  x0x1       10x0x10x       x0x10x  10x0
0x0x10x0            0x0x10 x10x0x10x0x1	    10x0x10x0x10          x0x1     0x10    0x0        x10x0x10
  0x10x0          x10x0x   x10x0x10x0x10x   10x0x10x0x10          x0x1     0x10x0x10x0        x10x0x10
    10x0x1      x0x10x     x10x             10x0                  x0x1     0x10x0x10x0          0x0x
      x0x10x0x10x0x1       x10x             10x0            x10x   x0x1    0x10x0x10x0x10       0x0x
        x10x0x10x0         x10x0x10x0x10x   10x0x10x0x10x0  x10x  10x0    0x0x        0x10      0x0x
          0x0x10           x10x0x10x0x10x   10x0x10x0x10x0    0x010x0     0x0x        0x10      0x0x    

                                                                                     version 1.5
                                                                                                 June 2019

       =================================================================================================

                        ::         Veejay, a visual instrument for GNU            ::
                                          http://veejayhq.net


Veejay - a 'visual' instrument and realtime video sampler

Veejay is a visual instrument and real-time video sampler.
It allows you to "play" the video like you would play a piano.
While playing, you can record the resulting video directly to disk (video sampling).


====== quick install:

   order of packages:
    **required** ; veejay-core, veejay-server
    **optional** ; veejay-client, veejay-utils, plugin-packs

   for each package:
     ./autogen.sh
     ./configure
     make && sudo make install
     sudo ldconfig

   to build for a specific target:
     ./configure --with-arch-target=generic|core2|k6|native|i686


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

     ./configure --enable-debug


   to build plugins:

   cd veejay-sever/livido-plugins
   ./RUNME.sh /tmp/plugins

   install the plugins in your home-dir:

   mkdir ~/.veejay    # or start veejay 
   echo "/tmp/plugins" >> ~/.veejay/plugins.cfg


   install GMIC,

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




FEATURE OVERVIEW

General
-------
 # Free Software (GNU GPL) (1)
 # Servent architecture (2)
 # Soft realtime (3)
 # Frame accurate (4)
 # Loop based editing (5)
 # Native YUV(A) processing
 # Crash recovery

Media
-----
 # Codecs: MJPEG, MPNG, DV, YUV (raw)
 # Containers: AVI, Quicktime, rawDV
 # Devices: USB webcams, DV1394, TV capture cards, etc.
 # Support for unlimited capture devices
 # Support for Image files (PNG ,JPEG, TIFF, etc)

Editing
-------
 # 161 built-in FX , many unique and original FX filters 
 # 60 Livido filters
 # FX chain (20 slots) with Alpha Channels
 # All FX parameters can be animated.
 # Mix up to two layers per FX slot
 # Non destructive edit decision lists (cut/copy/paste/crop video)
 # Sample editor
 # Sequence editor
 # Live disk recorder (sampling)
 # Full deck save/restore
 # Live clip loading 
 # Live sample sequencing

Trickplay
---------
 # VIMS event recording/playback (6)
 # Various looping modes including bounce and random
 # Playback speed and direction
 # Video scratching
 # Change in-and out points of a sample (marker)
 # Slow motion audio / video (7)
 # Fast motion audio / video
 # Dynamic framerate 
 # Random frame play
 # Random sample play
 # Access up to 4096 video samples instantly

Output
------
 # Audio trough Jack (low latency audio server) (8)
 # SDL video
 # Headless (no video output)
 # YUV4MPEG streaming
 # V4L2 loopback devices
 # Network streaming (unicast and multicast)
 * Preview rendering
 # Image grabbing

Interaction
-----------
 # Programmable keyboard interface
 # VIMS (tcp/ip)
 # OSC (udp)
 # PureData trough sendVIMS external
 # MIDI

Viewing
-------
 # Full screen or windowed mode
 # Perspective and foward projection (9)
 # Twinview/BigDesktop
 # Split-screen video wall


Plugins and more...
----------
 # Support for Frei0r plugins
 # Support for LiVIDO plugins
 # Support for FreeFrame plugins (only for 32 bit systems!)
 # Android server!




(1)	Free Software
	A matter of liberty, not price. You should think of  “free” as in free speech.
	Free software is the matter of the users freedom to run, copy, distribute, study, change and improve the software. 

(2)	A servent architecture is a peer-to-peer network mode with both functionalities of a
	server and a client. The setup is designed so that each veejay-node can send and receive video,
	allowing for the creation and maintenance of ad-hoc veejay-networks.
	Reloaded , veejay's graphical interface, is a thin client and can be run from another computer
	to track one or more veejay servers.

(3)	Soft realtime: A system is realtime if the correctness of the application not only depends on
	the logical correctness but also upon the time at which it was performed.
	Veejay tolerates such lateness and responds by dropping video frames. 
	You can instruct veejay to ignore the time aspect of the video and render all frames, effectivly
	turning the server into a frame producer.

(4)	VIMS: Veejay Internal Message System.  Control data is distributed via this message system,
	each message consists of an 'event selector' with a list of arguments.  VIMS is the lowest
	level control interface available. The keyboard interface and OSC server are built on top of it.
	Also all veejay clients communicate usings VIMS.

(5)	Loop based editing:  Loops are (short) sections of video (up to any length) that are repeated
	continuously. While playing, you can change the properties of the video sample, add filters to it
	and record it on the fly to a new sample (which can be used instantly).

(6)	Frame accurate: In veejay, every frame is a key-frame (a whole image).
	As a consequence, veejay has no support for video codecs that make use of difference frames.

(7)	In trickplay mode, veejay will always resample the audio analogous to varying the speed
	of an analogue tape recorder . Halve the speed results in the pitch going down an octave.
	Slow motion video is produced by linearly interpolating in-between frames and
	faster motion is accomplished by skipping video frames or, if playing without audio,
	by changing the framerate dynamically.

(8)	JACK: A low latency audio server that can connect a number of different applications to an audio device,
	allowing them to share audio between themselves. http://jackaudio.org/

(9)	Perspective Viewing: You can define a quadrilateral to which the rendered image will be mapped.
	This is usefull for setups where the image borders fall outside the projection screen area, or where
	the projector/camera has a (wide) angle to the projection.
	Last but not least, it can be used for on-body projection performances.





Install
=======

See file 'INSTALL'

See doc/Installation.md
See doc/HOWTO.compile.md
See doc/Howto_Compile_on_Ubuntu.html

Documentation
=============

See the directory 'doc' in this package, it contains a lot of usefull documentation.


Running
=======

Start 1 or more Veejay servers:
$ veejay my-movie-A.avi
$ veejay -p 4490 my-movie-B.avi

CONTACT / FEEDBACK & HELP
=========================

The veejay website is over http://veejayhq.net

You can join our mailing list on http://groups.google.com/group/veejay-discussion


BUG REPORTS / BLEEDING EDGE SOURCE CODE
=======================================

Please use the ticket system on https://github.com/c0ntrol/veejay/issues

The code is actually develloped from http://github.com/c0ntrol/veejay


ENJOY! And let us know about your performances/installations with veejay!