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!