diff --git a/veejay-current/README b/veejay-current/README
index 0f6246a7..ef010437 100644
--- a/veejay-current/README
+++ b/veejay-current/README
@@ -2,6 +2,10 @@
Veejay - Video Mixing/Editing Instrument
========================================
+Important:
+----------
+This version of veejay is not compatible with any earlier versions.
+
See:
README.quickstart
@@ -15,7 +19,7 @@ See:
Tips:
=====
-To see a list of key events, type 'man veejay' in your shell or try
+To see a list of all default keyboard events, type 'man veejay' in your shell or try
'cat veejay/vj-event.c |grep SDLK' for a more up to date version.
For users with Intel Pentium 4 processors with Hyper Threading, benefit
@@ -25,6 +29,10 @@ Since version 0.6.3, veejay doesnt have a console interface anymore!!!
Use 'sayVIMS -i' to enter interactive mode and give '?' or 'h'
to see a list of commands, or simply type VIMS style messages.
+Starting of version 0.8, Veejay has a graphical user interface GVeejay
+which is distributed with this package.
+The quickest way to start with Veejay is by launching gveejay.
+(No user manual on Gveejay yet).
PLUGINS
=======
@@ -63,8 +71,7 @@ examples:
2. run veejay without a video file
- veejay -d -W
v1.4, 24 May 2004
v2.0, 25 July 2004
v2.1 27 January 2005
+v2.2 22 April 2005
This document describes how to use veejay, a visual 'music' instrument for Linux/GNU
@@ -107,6 +108,8 @@ This document is targeted at the Linux user interested in learning a bit about v
-Veejay is a 'visual' instrument and realtime video sampler, featuring simple non-linear
- editing and mixing from multiple sources.
-You can load multiple video files, cut and paste portion
-s of video/audio and save it as an Edit Decision List.
Also, you can record new clips from
- existing clips or (live) streams.
With these clips you can change playback speed
- (slow motion/acceleration), change the looptype and set markers.
-
-With both clips and streams you can edit the effect chain and mix from multiple
-sources to one. Veejay currently has 94 effects, divided into two categories: Image and
- Video Effects, only with Video Effects you can select a channel to mix in.
-
-Veejay has many frame blending methods, some of these are: Additive,Substractive
-,Difference Negate, Relative Addition and Selective Replacement. Next to blendin
-g, you can key on Luma and Chroma seperatly or combined or simply use Transitions
-or other effects. Veejay has over 100 original video effects, most of them you will
-not find anywhere else (except those few ported from EffecTV, Mplayer, The Demo Effect Collection)
-
-
-Most edit and navigation commands are mapped to single key press commands, this
-allows you to control, depending on the playback mode, video navigation, the eff
-ect chain, effect parameters and other properties at playback time.
-
-Also, you can record a new clip on the fly from a live feed or from the video cl
-ip you are playing. If requested, the recorded videofile will be added to the ed
-it descision list and activated as a new video clip. This is particular usefull
-for time-looping,rebouncing and rough clip scratching/editing.
-Veejay can be remotely controled through using OSC (Open Sound Control) or via
-its own internal message system 'VIMS'.
'VIMS' allows you to create/load/save
-effect chain templates and to add customized events which can be triggered by a
-keypress or by a remote message.
-Finally, you can stream (uncompressed) video over the network from peer to peer over TCP
-or by using multicast over UDP (one to many).
+Veejay is a visual instrument and realtime video sampler.
+It allows you to 'play' the video like you would play a Piano
+and it allows you to record the resulting video directly to disk for
+immediate playback (video sampling).
-
+Thus, Veejay can be operated live by using the keyboard (which is 100%
+user definable) and remotely over network (both unicast and multicast)
+using an inhouse message system that allows mapping of various protocols
+on top of it, like OSC (OpenSoundControl).
+Veejay is beeing developed in the hope it will be usefull for VJ's,
+media artists and other interested users that want to use Free Software
+for their performances and/or video installations.
+
+As of version 0.8 Veejay comes with a graphical user interface GVeejay.
+You can use GVeejay to connect (and switch) to any Veejay on the network , alternativly
+it can launch a veejay locally on your machine.
+Use GVeejay to customize keyboard mappings and save the configuration file.
@@ -178,13 +164,14 @@ or by using multicast over UDP (one to many).
+
Veejay requires at least a linux kernel 2.4.x, 2.6.x or later, a lot of diskspace and a fast CPU.
Depending on the speed of your machine, your milage may vary. See the list below for
@@ -232,24 +223,26 @@ a few systems veejay was reported to work on:
-Before you install Veejay, make sure you have the following dependencies installed:
+Before you install Veejay, you should install the following software packages.
+Although none of them is required, Veejay will be much less usable without them.
-$ tar -jxvf veejay-0.7.x.tar.bz2 +$ tar -jxvf veejay-0.8.x.tar.bz2Change to the directory containing veejay's source's:
-$ cd veejay-0.7.x +$ cd veejay-0.8.x $ ./configureOn completion it will summarize the results of the ./configure script, which could look like this:
-veejay 0.7.2 build configuration :
-
-Compiler flags: -mcpu=i686 -march=i686 -Wall -Wunused -g
-
- Build configuration:
- x86 Architecture : true
- MMX enabled : true
- MMX2 enabled : false
- SSE enabled : true
- 3DNow enabled : false
- CMOV enabled : true
- glibc support for >2GB files : true
-
- Required dependencies:
- POSIX Threads (pthread) : true
- video4linux recording/playback : true
- libJPEG : true
-
- Optional dependencies:
- libDV (digital video) : true
- Jack Audio Connection Kit : false
- DirectFB support : false
- Simple Direct Media Layer : true
- XML C library for Gnome libxml2 : true
-
- Plugin dependencies:
- FreeType support : true
- Veejay Video Objects support : true
-
+configure:
+configure: Veejay 0.8.0 build configuration :
+configure:
+configure: Compiler flags: -march=pentium4 -mcpu=pentium4 -fno-common -O2 -fomi
+t-frame-pointer -malign-double -mfpmath=sse -Wall -Wunused
+configure:
+configure: Architecture: i686
+configure:
+configure: x86
+configure: MMX enabled : true
+configure: MMX2 enabled : false
+configure: SSE enabled : true
+configure: SSE2 enabled : true
+configure: 3DNOW enabled : false
+configure: CMOV enabled : true
+configure: Nasm enabled : true
+configure:
+configure: Platform: Linux
+configure:
+configure: Required dependencies:
+configure: - POSIX Threads (pthread) : true
+configure: Optional dependencies
+configure: - video4linux : true
+configure: - SDL support : true
+configure: - DirectFB support : false
+configure: - AVI MJPEG playback/recording : true (always)
+configure: - libDV (digital video) support : true
+configure: - JPEG support : true
+configure: - jack : false
+configure: - xml c library for gnome : true
+configure: - freetype support : true
+configure:
+configure: - GVeejay UI
+configure: share : ${prefix}/share/veejay
-Dont worry if you dont have 'Veejay Video Objects support' ; it is still in development.
Now, you can start building veejay
$ make @@ -318,23 +315,24 @@ Followed by-
-First of all, you need to have Video For Linux enabled in your kernel configuration.
-Make sure that V4L information in proc filesystem is enabled; veejay uses the proc file
-system to find out what devices can be used to read from.
-
-Secondly, in order to use multicast streaming, you must have the option IP multicast
-enabled in your kernel configuration. Also, you need to add a multicast route :
-
-$ route add -net 224.0.0.0 netmask 255.255.255.0 dev eth0 -+
-Chapter 4.2 sayVIMS includes examples to create several
-types of input streams
+Multicast is a technology that reduces network traffic by
+simultaneously delivering a single stream of information
+to any interested recipient.
-Veejay can stream out to SDL (video window), to STDOUT (in yuv4mpeg) , to DirectFB secundary head (TV-Out)
-and it can stream over the network (all is uncompressed video). See the man page on how to activate one
-or more of these options.
+To enable multicast in Veejay, you must have enabled IP multicast
+in your kernel configuration.
+
+Finally you need to add a multicast route :
+
+ $ route add -net 224.0.0.0 netmask 255.255.255.0 dev eth0 ++
@@ -402,7 +400,7 @@ This limitation is also valid when streaming video from veejay to another veejay
sayVIMS is a commandline utility distributed with the veejay package,
-it allows you to give short commands in interactive mode
+it allows you to give short commands in interactive mode
$ sayVIMS -i -h localhost -p 3490
Typing '?' followed by pressing ENTER gives the list of command below:
@@ -431,21 +429,23 @@ Typing '?' followed by pressing ENTER gives the list of command below: Also, you can send messages in VIMS format (or files, containing VIMS messages )Or, if you want to play a XVID movie (or any other compressed format that is not I frame only):
For example, add the Pixelate effect on the Effect Chain of the current playing stream or clip:-sayVIMS -h localhost -p 3490 "182:0 0 150 3;" +sayVIMS -h localhost -p 3490 "361:0 0 150 3;"-See the VIMS document in the source package for a more detailed (but not yet complete) overview.
-
-For example, you can open /dev/video0, channel 0 (composite port) by giving the VIMS message:
+Last but not least, sayVIMS can parse files containing VIMS messages.
+See the test/examples directory of the package for a list of perl +scripts that output a VIMS script.
-$ sayVIMS -h localhost -p 3490 "144:0 0;" +sayVIMS -f advocate.vims -h localhost -p 3490+See the VIMS.txt file in the source package for a more detailed (but not yet complete) overview.
+
Alternativly, you can start a secundary veejay and stream from peer to peer in uncompressed video:
$ veejay -d -p 5000 -$ sayVIMS -h localhost -p 5000 "165:localhost 3490;" +$ sayVIMS -h localhost -p 5000 "245:localhost 3490;" (press 'F7' in veejay to display the stream, prob. stream 7)@@ -455,30 +455,21 @@ $ veejay -V 224.0.0.50 -p 5000 -n -L movie1.avi $ veejay -d -$ sayVIMS -h localhost -p 3490 "166:224.0.0.50 5000;" +$ sayVIMS -h localhost -p 3490 "246:224.0.0.50 5000;" $ veejay -d -p 4000 -$ sayVIMS -h localhost -p 4000 "166:224.0.0.50 5000;" +$ sayVIMS -h localhost -p 4000 "246:224.0.0.50 5000;"
-$ sayVIMS -h localhost -p 3490 "149:/tmp/my-XVID-movie.avi;" +$ sayVIMS -h localhost -p 3490 "244:/tmp/my-XVID-movie.avi;"
-The keyboard interface takes keypresses (events) from SDL, almost all keys on
-your keyboard have a function in veejay.
-
-Typically, the keys on your numeric keypad can be used for navigation (play forward, play backward,
-skip frames, skip to end , skip to start , etc).
-The keys a,s,d,f,
-g,h,j,k and l can be used to increase speed from 1 (normal) to
-9 (fast)
-
-Here is a quick overview for the most commonly used keys, if applied in order you will end up
+Here is a quick overview for the most used default keys, if applied in order you will end up
with a newly created video sample looping in some way (depending on how many times you press the asterix key)