Kino

by  Dan Dennedy <dan@dennedy.org>
    Charlie Yates <charles.yates@pandora.be>
    Arne Schirmacher <kino@schirmacher.de>
    Mads Bondo Dydensborg <madsdyd@challenge.dk>

main user site: http://www.kinodv.org/
bug reports site: http://sourceforge.net/tracker/?group_id=14103&atid=114103
developer site: http://sf.net/projects/kino/


See the NEWS file for RELEASE NOTES!


-----------------------------------------------------------------------------
Introduction
-----------------------------------------------------------------------------
Kino is a non-linear DV editor for GNU/Linux. It features excellent
integration with IEEE 1394 for capture, VTR control, and recording back to
the camera. It captures video to disk in raw DV or AVI format in both type-1
DV and type-2 DV (separate audio stream) encodings. Kino does not support other
video file formats or encodings. However, it can import other formats by
transcoding them using FFmpeg and optionally MEncoder.

One can load multiple video clips into a playlist, cut and paste portions of
video/audio, and save it to a file in SMIL format. Most edit and navigation
commands are mapped to equivalent vi key commands. Also, one can apply a
number of effects such as audio and video filters and transitions, and render
the effect to a new DV file that is automatically edited into playlist.
Finally, one can export the playlist to a number of formats including audio
only, still images, DVD Video, Ogg Theora, MP4 and others.

For more information, please read the NEWS file, which contains functional
changes and important notices for each new version. The ChangeLog contains
a more detailed, technical account of the changes in each version. Valuable
information is contained in these files unless you can read C/C++ source 
code. Also, the discussion forums on the user website above are very
helpful.

-----------------------------------------------------------------------------
Requirements and Recommendations
-----------------------------------------------------------------------------

Kino requires a combination of two DV codecs:
libdv (http://sf.net/projects/libdv/) for audio and metadata handling and
FFmpeg (http://ffmpeg.mplayerhq.hu/) for the video.

The Linux IEEE 1394 subsystem is required for DV/1394 I/O. Linux1394 comes
with Linux kernels 2.4 and 2.6.
(http://www.linux1394.org/)

Every linux1394 installation also needs libraw1394 and libiec61883.
(http://www.linux1394.org/)

Libavc1394 is required for compilation even if you do not have IEEE 1394.
It provides camera capabilities discovery, and VTR control.
(http://sf.net/projects/libavc1394/)

GTK 2.6 is required and provides most of the additional packages need to
build Kino. You will need both the runtime and -dev packages to compile Kino.

We currently support GDK or XVideo for the computer video display. XVideo (Xv)
is strongly recommended for performance reasons. XFree86 4.x or X.Org and a 
compatible display adapater and driver are required for XVideo extensions.

We currently only support OSS and ALSA audio, not esd or arts. You can disable
audio in the Preferences dialog if you need to.

-----------------------------------------------------------------------------
Build and Installation
-----------------------------------------------------------------------------
Following is a list of libraries used during linking:

libgthread-2.0 
libglade-2.0
libgtk-x11-2.0
libgdk-x11-2.0
libatk-1.0
libgdk_pixbuf-2.0
libpangoxft-1.0
libpangox
libpango-1.0
libgobject-2.0
libgmodule-2.0
libglib-2.0
libsamplerate
libXv
libXext
libasound
libpthread
librom1394
libavc1394
libiec61883
libraw1394
libdv
libavformat
libavcodec
libavutil
libSM
libICE
libxml2
libstdc++
libc
libgcc
libdl
libz
libm

Additional libs that are dependencies of these libs may include:
libX11
libXrandr
libXi
libXinerama
libXft
libfreetype
libfontconfig
libXfixes
libXrender
libpangoft2-1.0
libexpat
libpangocairo
libcairo

You must have installed GTK2 and libglade and their -dev packages. On a system
with a package manager, installing libglade2-dev(el) will pull in most of the
dependencies.

1. Install libdv
2. Install libraw1394
3. Install libavc1394
4. Install libiec61883
5. test capture using dvgrab. (You may find that you need to enable DMA on
    your IDE hard drive using the hdparm utility.)
    You can get dvgrab from http://www.kinodv.org/.
6. Install libsamplerate
7. Install Kino:
    ./configure
    make
    sudo make install
    
    IMPORTANT:
    You must do the 'make install' step or Kino will not be able to load
    its button images or the online help. Currently, a 'make uninstall'
    does not delete the items; however, it does delete the binary and
    man page.
    
8. run kino

-----------------------------------------------------------------------------
Build Options
-----------------------------------------------------------------------------
If you want to use Quicktime DV files, then install Quicktime 4 Linux
(http://www.heroinewarrior.com/ or http://cvs.cinelerra.org/) or a compatible
(http://sf.net/projects/libquicktime) library. Then, you must run the
configure script with the --enable-quicktime option.

By default, Kino uses a private copy of ffmpeg to which it statically links.
If you wish to use a shared installation of the ffmpeg libraries, then use 
the configure option --disable-local-ffmpeg. After that, the configure script
tries to use pkg-config to locate ffmpeg. If you are using an older version
without pkg-config, then use the following options to tell Kino how to compile
and link against ffmpeg:
--with-ffmpeg-cflags
--with-ffmpeg-libs
You can also use the above configure options to statically link Kino to a
specific version of ffmpeg that has already been compiled. Finally, you can
disable the usage of ffmpeg altogether using the option --with-libdv-only.

The last option concerns support for USB Jog/Shuttle devices. Kino provides
some Linux 2.6 udev rules to setup the input/evdev device file permission
associated with your controller. It also sends a signal to a running instance
of Kino to let it know that it has been connected. The following configure
option tells the installer where to place the udev rules:
--enable-udev-rules-dir=PATH
One can also use --sysconfdir=DIR (e.g., /etc).

-----------------------------------------------------------------------------
Getting Started
-----------------------------------------------------------------------------
After starting Kino, we suggest that you review Preferences to setup the
initial configuration. After loading some video files, you can tweak various 
settings for the best performance and experience.

When you load a DV clip, Kino attempts to detect scenes by looking for
discontinuities in the timecode. It renders each scene break with a vertical
line in the scrub bar below the video preview area.

Likewise, when you capture video and enable autosplit, Kino detects scene
changes in your source video and generates a new DV file. Kino also has options
to start a new file when it exceeds the maximum number of frames per file (as
set in Preferences).

We strongly suggest you use the keyboard commands instead of the menus and
toolbar. There are for more keybaord commands than there are menu options.
Press Ctrl+F1 to open a keyboard quick reference window.

-----------------------------------------------------------------------------
HELP!
-----------------------------------------------------------------------------

Please read the online documentation for more information.

If Kino has trouble launching the online help, make sure you
properly configure a default web browser in the GNOME or KDE Control Center.
If all else fails, then directly access the documents at
$prefix/share/kino/help/ where "$prefix" is usually either "/usr" or
"/usr/local." You also reference the documentation at the website at
http://www.kinodv.org/docbook/

Finally, you can consult the Kino discussion forum
or authors using the information at the top of this README.

Another form of help is through contribution: whether that is code,
documentation, support, or just sharing the videos you have created!
