Installation Instructions for Kinetophone

Required Libraries and Tools
============================

(These components may have additional dependencies.)

GNU C Compiler -- GCC (Version 4.4 or later recommended) with:
  GNU C++ compiler
  GNU Standard C++ Library
  GNU C Library (libc6)

GNU Make (Version 3.81 or later recommended)

PortAudio 19 (Subversion date 20100802 or later recommended)

libsndfile (Version 1.0.21 or later required)

Boost C++ Libraries (Version 1.42 or later required) including the
following if separately packaged:
  Filesystem Library
  Program Options Library

ncurses 5 (Version 5.7 or later recommended)

gtkmm 2 (Version 2.8.0 or later required)

libxml++ 2 (Version 2.30.0 or later required)

FFmpeg or Libav
  FFmpeg: libavformat (Version 52.31.0 [ffmpeg-0.5.1] to Version 55.33.100 [ffmpeg-2.2] supported)
  FFmpeg: libavcodec (Version 52.20.1 [ffmpeg-0.5.1] to Version 55.52.102 [ffmpeg-2.2] supported)
  FFmpeg: libavutil (Version 49.15.0 [ffmpeg-0.5.1] to Version 52.66.100 [ffmpeg-2.2] supported)
  - OR -
  Libav: libavformat (Version 52.31.0 [ffmpeg-0.5.4] to Version 54.20.3 [libav-0.9.12] supported)
  Libav: libavcodec (Version 52.20.1 [ffmpeg-0.5.4] to Version 54.35.0 [libav-0.9.12] supported)
  Libav: libavutil (Version 49.15.0 [ffmpeg-0.5.4] to Version 52.3.0 [libav-0.9.12] supported)


Poppler
  poppler (Version 0.12.4 or later required)
  poppler-glib (Version 0.12.4 or later required)

Optional Libraries and Tools
============================

For vox (narration tool using speech synthesis, build enabled by default):
  festival (Version 1.96~beta10 or later required)

For the experimental DBus server (build disabled by default):
  libdbus-1 (Version 1.2.16 or later required)
  libdbus-c++-1 (Version 0~20090907 or later required)

For creating the PDF tutorials from the LaTeX source:
  TeX Live (Version 2009-7 or later recommended)

For creating HTML versions of the man pages:
  man2html (Version 1.6f-3 or later recommended)


Platforms
=========

Currently, Kinetophone only supports the GNU/Linux platform.

GNU/Linux
---------
Kinetophone uses the usual:

  ./configure; make; sudo make install

command sequence to configure, make, and install the program.

Use the command:

  ./configure --help

to see options for the configure script.


----

Copyright 2011-2014 Roan Trail, Inc.

This file is part of Kinetophone.

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

Kinetophone 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. See the GNU
General Public License for more details.  You should have received
a copy of the GNU General Public License along with Kinetophone. If
not, see <http://www.gnu.org/licenses/>.
