Skip to content

Latest commit

 

History

History
116 lines (70 loc) · 4.23 KB

README.quickstart.md

File metadata and controls

116 lines (70 loc) · 4.23 KB
    //    ) )                                             //   ) )                                        
   //    / /                ( )      ___       / ___     ((         __  ___     ___        __     __  ___ 
  //    / /     //   / /   / /     //   ) )   //\ \        \\        / /      //   ) )   //  ) )   / /    
 //  \ \ /     //   / /   / /     //         //  \ \         ) )    / /      //   / /   //        / /     
((____\ \     ((___( (   / /     ((____     //    \ \ ((___ / /    / /      ((___( (   //        / /

It is advised to read the howto and the MAN page as well.

Launch and select source

You can launch veejay with

$ veejay -d

This should show some moving black/white footage. Most of the effects will be boring on this footage, so you can try to open your video4linux device with

$ sayVIMS -m "240:0 1;" (device 0, channel 1)

or your dv1394 firewire device.

$ sayVIMS -h localhost -p 3490 -m "241:63;"

To use mplayer, create a FIFO first:

$ mkfifo stream.yuv

Use something like mplayer -vo yuv4mpeg -x 352 -y 288 -vf scale -zoom

and open the stream in veejay's console:

$ sayVIMS -m "243:stream.yuv;"

Move your mouse pointer to the SDL window (so it dissapears) and press 'ESC' to switch from the dummy footage to the last created or played video stream.

Try loading an AVI file with something like:
(mjpeg-video-file.avi must be encoded for veejay, see codec

$ veejay -v -g mjpeg-video-file.avi

The -v commandline option generates extra debugging output.
The -g load clips has samples.

By default, veejay uses a SDL window for displaying video. You can specify veejay to write to STDOUT :

$ veejay -O3 -o stdout mjpeg-video-file.avi | yuvplay

In this mode, the console input and SDL keyboard functions are disabled. You must use the sayVIMS commandline utility to interact with veejay or with an alternative utility like sendOSC. Refer to the howto VIMS for more information.

Let's discover with some SDL keyboard functions :

Sampling and select sample

Once you have loaded veejay, preferably with a videofile :

  • press [KP 1] , [left bracket], [KP 3], [right bracket] , [F1]

This will create a virtual clip (in memory) from your entire video file.

  • If you press [KP divide] , veejay will return to plain video mode so you can create more clips.

  • If you press [ESC] , veejay will switch from playing streams to playing clips or vice versa

  • Press [F1] to [F12] to select a clip,

  • Press [SHIFT] + [t] to toggle transitionning between clips,

  • Press [1] to [9] to quick jump into clip position, 10%, 20%, 30% ect.

  • Press [SHIFT] + [1] to [9] to select a clip bank (1 = clips 1 to 12, 2 = clips 12 to 24, etc )

Add an effect

Once you are playing a clip/stream, simply press

  • [Cursor UP] , [ENTER]

To add an effect in the current effect chain entry.

If you add a video effect, try pressing [-] and [=] to select another channel and [/] to toggle between clip/stream sources

Effect chain

Veejay supports chaining of effects since day 0, a number of keys have some importance :

  • [-] ,[=] and [/] , select previous / next channel and toggle sources
  • [END] enable / disable the chain
  • [KP -] select the previous entry
  • [KP +] select the next entry
  • [ALT]+[END] enable / disable the current selected entry
  • [ENTER] add an effect from the list to the chain
  • [DEL] remove an effect from the chain

More keys ?

Also, you can press [HOME] to see clip or stream information.

Try the keys [A] to [L] to increase/decrease playback speed.
Try the keys combinaison [ALT] + [A] to [L] to increase/decrease frame repetition.

See man veejay for an overview of both console input and SDL keyboard events

Load custom chain

Also, you can load some predefined custom effect chain templates that will put a template on your effect chain when you press SHIFT + some alphabetic character.

First, load an action file

$ veejay -l test/livecinema/action-file.xml

Or in veejay's console

al test/livecinema/action-file.xml

(activate a stream or clip and) press [SHIFT]+[S] or [SHIFT]+[B] or [SHIFT]+ ...

Enjoy!