GVeejay - Front End for veejay a video mixing/editing Instrument
================================================================

Also read 'README.Usage'


A visual 'music' instrument (video mixing and editing)

Short description:

Veejay is a video tracker/editing tool and visual instrument for Linux, suitable for
live performances and editing environemnts

The project emphasises direct (user) interaction, it is possible to navigate
through video samples, define various types of looping, increase and d
ecrease playback speed, navigate through the effect chain to apply a chain 
of effects using the keyboard while the interface keeps track of what you are doing 

It supports multiple capture/tv cards (video4linux devices), vloopback and yuv4mpeg and it supports mixing of multiple cards to a single output.

It supports simple video editing on a DV or MJPEG file , you can save an
edit decision list which can be processed by the mjpegtools. 


Future
======

- Pattern Editor  (TimeLine)
- Pattern Instrument (TimeLine instrument)


What is in the Package
======================

 gveejay  : the GTK interface for easy-editing

Basic Usage
===========

You can create a sample with the |- and -| buttons, on the top right corner
of the screen. Next, select the newly created sample in the list and 
click 'Edit' to activate the Sample Editor.

You can add up to 10 effects/transistions to the Sample Chain and adjust 
their parameters (if appropriate) P0 to P8.

You can toggle the Effect Chain by clicking on it. (i.e. Preview)

The status text box on the bottom gives extra information.
 

See the doc/ directory for more in depth information.


RENDERING
=========

- new in 0.4.2

You need to start gveejay in the same directory you have started veejay in,
If you are running gveejay you might want to look into Samba's documentation
for sharing a filesystem over network. 



REQUIRED/RECOMMENDED SOFTWARE
=============================

To compile the GUI you need:

GTK-1.2.x     : http://www.gtk.org
The Mjpegtools: http://mjpeg.sourceforge.net


To run the GUI you need:
veejay-0.4.9  : http://veejay.sourceforge.net



Running Veejay
==============

Start the core with
	
'veejay <options> <filename 1 ,... , filename N>'

examples:


--------------------------------------------
1. have a small SDL window (for the keybindings) and DirectFB:

   'veejay -a0 -G2 -n8 -v2 -S171x144 /video/video.avi'


About the parameters
--------------------

	'-n'   : specify number of buffers to use ( 8 = normal , 1 or 2 is good for slower machines)
	'-v'   : specify to be verbose 
	'-G'   : select graphics driver , 0 = sdl, 1 = directfb, 2 = both
	'-S'   : size of SDL window
	'-t'   : timer to use (0=none,1=nanosleep, 2=rtc)		
	'-p'   : specify port number to use (default 3490)

Start the GUI with

'gveejay localhost 3490' 
or
'gveejay <veejay host> 3490' 



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

Niels Elburg <elburg@hio.hen.nl / nielselburg@yahoo.de >

For usage related questions:

http://veejay.sourceforge.net




ENJOY!


