
          [[[  FreeJ 0.6 "MONTEVIDEO"  ]]]

             [ http://freej.dyne.org ]

       BIG UP ALL FRIENDS & SET THE VJ FREE
                     by jaromil @ RASTASOFT 

:: OVERVIEW

FreeJ is a digital instrument for video livesets, featuring realtime
rendering of multilayered video and chained effect filtering directly
on the screen. FreeJ threats every video source as a layer, making
then possible to dynamically apply on each a chain of filters,
loadable as effect plugins and easily customizable. Layers are
implemented to mix together live inputs (video4linux devices),
DIVX/AVI files (with avifile library), PNG images and text files word
by word. Other layers are being implemented.

FreeJ is a software written in C, C++ and a bit of assembler, it can
run on GNU/Linux platform and it could be ported to other platforms:
any help on that is appreciated.

FreeJ is being developed in the hope to provide the free software
community with a modular and highly customizable application for
realtime video manipulation; a free and open framework that lets
anybody implement hisown filters concentrating simply on the dsp
algorithm developed and furthermore to combine them over any supported
layer.

FreeJ is Free Software and his sourcecode is released under the Gnu
Public License, it comes with absolutely no warranty and you are welcome
to redistribute it under certain conditions (refer to the license for
details).


:: FreeJ development is supported by
   Montevideo/Time Based Arts - Nederlands Instituut voor Mediakunst



:: FEATURES

++ reads from multiple sources:
   video4linux, divx/avi movies, png images and txt files
++ very efficient video engine with multithreaded layers
++ plugin effects chainable on each layer
++ user friendly GTK2 graphical interface
++ (ab)user friendly hotkeys and OnScreenDisplay
++ 100% GNU General Public License Free Software
++ modular C/C++ code and flexible API




:: REQUIREMENTS

To run FreeJ is necessary to have:

- a working GNU/Linux workstation
  (experimental support for Darwin/OSX)
- SDL libraries http://www.libsdl.org

Optionally, you want to have installed the following libraries in order
to use various input plugins:
- PNG libraries http://www.libpng.org
- FreeType2 libraries http://freetype.org
- FFMpeg libraries http://ffmpeg.sf.net
- XVid libraries http://xvid.org
- AviFile libraries http://avifile.sf.net
- XFree86 4.2 or latest, better with an accelerated videocard
- NASM netwide assembler compiler http://nasm.sf.net

Also a video input device can provide you with additional phun, FreeJ
currently supports the video4linux API.

For better fullscreen support try to add to your XF86Config  file  the
modelines in doc/x11.modelines

To operate FreeJ you need to have a look in the USAGE file




:: HOW TO INSTALL IT

read the INSTALL file
if it's too hard for you, consider trying dyne:bolic
*** http://dynebolic.org (just download, burn and boot it on a PC!)




:: DEVELOPERS

 jaromil - FreeJ author and mantainer
 kysucix - Truetype TXT Layer
 & refer to the AUTHORS file for a list of contributions

You are very welcome to join, there is a lot of space for modules and a
pretty clear (and near to be freezed) API to be used.
In the near future there is going to be a procedural scripting language
to operate FreeJ. Have a look in the TODO file for some visions.
You can also follow development activity on http://lists.dyne.org/coding




:: DISCUSSION

Come and visit the irc.freenote.net channel #dyne

A mailinglist  for  further  discussion  about  FreeJ  is  running  as
<freej@dyne.org>, subscription is opened and  anybody  interested  can
send a mail to <freej-subscribe@dyne.org> to join. Online archive is
on http://live.dyne.org/freej




:: AVAILABILITY

The source releases of FreeJ are made available on
       *** http://freej.dyne.org ***

FreeJ is also included in binary form, ready to be used, in the live
bootable distribution i'm doing: just burn it and boot it!
       *** http://dynebolic.org ***

CVS (latest development version) is also publicly available on
       *** cvs.dyne.org/viewcvs.cgi/?root=free ***





:: DISCLAIMER

FreeJ is (c) 2001, 2002, 2003 by Denis Rojo <jaromil@dyne.org>

This source code is free software; you can redistribute it and/or
modify it under the terms of the GNU Public License as published 
by the Free Software Foundation; either version 2 of the License,
or (at your option) any later version.

This source code is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Please refer to the GNU Public License for more details.

You should have received a copy of the GNU Public License along with
this source code; if not, write to:
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

$Id: README,v 1.16 2003/12/29 23:12:09 jaromil Exp $

