Kino by Arne Schirmacher <kino@schirmacher.de> Dan Dennedy <dan@dennedy.org> Charlie Yates <charles.yates@pandora.be> main user site: http://www.schirmacher.de/arne/kino/ bug reports site: http://bugzilla.schirmacher.de/ developer site: http://sf.net/projects/kino/ ----------------------------------------------------------------------------- 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 AVI format in both type-1 DV and type-2 DV (separate audio stream) encodings. You can load multiple video clips into a playlist, cut and paste portions of video/audio, and save it to a playlist. Most edit and navigation commands are mapped to equivalent vi key commands. Also, Kino can load playlists and save the composite playlist as a new DV AVI file. Finally, Kino can save a single frame of video (a still) in numerous file formats (based upon file extension). Currently, Kino does not support other video file formats or encodings. It does not support multiple layers or tracks of video and audio. It does not do image processing, titling, transitions, or effects. We plan to implement most of these features, but first we chose to focus on the basics of IEEE 1394, video, audio, and file input and output. We place a lot of emphasis on quality, stability, performance, and workflow. 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 ----------------------------------------------------------------------------- libdv is the required DV codec that we use. (http://sf.net/projects/libdv/) The Linux IEEE 1394 subsystem is required for DV/1394 I/O. Linux1394 comes with Linux kernels 2.4+; a patch is available for kernel 2.2 from the project website. (http://linux1394.sf.net/) Every linux1394 installation also needs libraw1394. (http://sf.net/projects/libraw1394/) 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/) GNOME 1.4 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. Many users find they need to install libdb2+ as well. We currently support GDK or XVideo for the computer video display. XVideo (Xv) is strongly recommended for performance reasons. XFree86 4.x and a compatible display adapater and driver are required for XVideo extensions. We currently require XFree86 4.x for building Kino, but if you have an older version, then simply edit src/Makefile.am and remove "-lXv" from the line beginning with "kino_LDADD=". We currently only support OSS audio, not esd, arts, or alsa. You can disable audio if you need to. ----------------------------------------------------------------------------- Build and Installation ----------------------------------------------------------------------------- Following is a list of libraries used during linking: -lgnomeui -lart_lgpl -lgdk_imlib -lSM -lICE -lgtk -lgdk -lgmodule -lXi -lXext -lX11 -lgnome -lgnomesupport -lesd -laudiofile -lm -ldb -lglib -ldl -lpthread -lgthread -lraw1394 -ldv -lXv -lavc1394 -lrom1394 You must have installed GNOME and its -dev packages, in addition to the DV/1394-specific packages. 0. Upgrade to XFree86 4.x. After doing so, run the xvinfo utility command to see if you display adapater supports XVideo. Consider purchasing a new display adapter if it does not support XVideo. 1. Setup linux1394 per the Getting Started Guide on their website. 2. Install libdv. 3. Install libavc1394. 4. 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.schirmacher.de/arne/dvgrab/. 5. Install Kino: ./configure make su make install exit 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. 6. If you using a version of linux1394 that is older than the one that comes with kernel 2.4.9, then you need to install the video1394 drivers that come with Kino: su cp video1394.* /usr/src/linux/drivers/ieee1394 cd /usr/src/linux make modules modules_install insmod video1394 mknod -m 666 /dev/video1394 c 172 0 (if /dev/video1394 does not exist) exit 7. run kino If you have a Sony JogShuttle or Contour ShuttlePro USB input device, then see README_jogshuttle. If you want to use Quicktime DV files, then install Quicktime 4 Linux (http://www.heroinewarrior.com/) or a compatible (http://sf.net/projects/libquicktime) library. Then, you must run the configure script with the --with-quicktime option. You may want to use ffmpeg's libavcodec to decode DV video instead of libdv. For instance, libavcodec has accelleration for PowerPC in addition to SSE/MMX, whereas libdv only has MMX accelleration. However, Kino still needs libdv to support audio and metadata. Run the configure script with the --with-avcodec option as well as --with-avcodec-include=<path to libavcodec includes directory> and --with-avcodec-lib=<path to libavcodec static library.a>. ----------------------------------------------------------------------------- Getting Started ----------------------------------------------------------------------------- After starting Kino, we suggest that you review Preferences to setup the initial configuration. After loading some AVIs, you can tweak various settings for the best performance and experience. When you load an AVI, Kino attempts to detect scenes by looking for discontinuities in the timecode. It renders each scene break with a vertical line in the location indicator at the bottom of the window. Kino also refers to scenes as sequences. Likewise, when you capture video and enable autosplit, Kino detects scene changes in your source video file and generates a new AVI file. Autosplit also tells Kino to start a new file when it exceeds the maximum number of frames per file (as set in Preferences). You also set the filename to capture to 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. ----------------------------------------------------------------------------- HELP! ----------------------------------------------------------------------------- Please read the online documentation for more information. If Kino/GNOME has trouble launching the online help, make sure you properly configure a default web browser in the GNOME Control Center. If you run Kino from the console/shell, then it reports on stdout the command it attempts to use to launch the online help. That should help debug issues. If all else fails, then directly access the documents at $prefix/gnome/help/kino/C/ where "$prefix" is usually either "/usr/share" or "/opt" -- if not, then you probably know what it is! Finally, you can consult the Kino discussion forum or authors using the information at the top of this README.