INSTALL

   1 terminatorX INSTALL
   2 ===================
   3
   4 Copyright (C) 1999-2020 by Alexander König <alex@lisas.de>
   5 https://terminatorX.org
   6
   7 Quickstart
   8 ----------
   9
  10 If you want enhanced audio-file support or optimization don't
  11 "quickstart" but read the rest of this file.
  12
  13 If you just cant wait any longer try:
  14 > ./configure
  15 > make install
  16
  17 Step 1: Configure terminatorX
  18 -----------------------------
  19
  20 If you want your compiler to optimize the binary, you need to set your
  21 environment variable CFLAGS to your needs BEFORE you run ./configure.
  22
  23 for example:
  24 if use bash: > export CFLAGS="-O2"
  25 with tcsh:   > setenv CFLAGS "-O2"
  26
  27 Optionally you might want to add additional tuning parameters for
  28 your target platform.
  29
  30 All of the following configure options can be either enabled with
  31 --enable-option or disabled with --disable-option.
  32
  33 The ./configure Options
  34 -----------------------
  35
  36 ### File support options
  37
  38 All of these are enabled by default. Nevertheless the configure
  39 script checks for the availability of the helper application
  40 and if it's not found disables support for it. Check the
  41 terminatorX homepage for links to those apps if you don't have
  42 them - or check your distribution first, AFAIK all bring these
  43 tools nowaday.
  44
  45 --enable-mad
  46
  47 This will make terminatorX use the MPEG Audio Decoder library if
  48 it's detected. This allows terminatorX to load mp3 files
  49 significantly faster than with the mpg123 method. Additionally
  50 terminatorX will find out about the sampling rate of an mp3 file
  51 and adjust the playback speed accordingly.
  52
  53 --enable-vorbis
  54
  55 This will make terminatorX use the OGG Vobris libraries to load
  56 OGG files directly. This method has the same advantages over
  57 loading through ogg123 as the "mad" method has over loading
  58 through mpg123.
  59
  60 --enable-audiofile
  61
  62 This enables the use of libaudiofile on loading audio files.
  63 The library supports a wide range of common audio file formats
  64 (eg WAV/AIFF/AU etc) therefor its use highly recommended.
  65
  66 --enable-wav
  67
  68 This enables the builtin wav routines. They load 16Bit/44Khz
  69 MONO RIFF/WAV files only but they do that significantly faster
  70 than using sox. If these routines fail and sox support is
  71 enabled, terminatorX will try to load the file with sox as
  72 a fallback. Disable them only if they don't load your files
  73 correctly.
  74
  75 --enable-sox
  76
  77 This enables sox support. As sox can load nearly any audio file
  78 it makes sense to use it. You have to have sox installed of
  79 course.
  80
  81 --enable-mpg123
  82
  83 This enables mpg123 support. If you want to be able to load mp3
  84 files keep this option enabled. You have to have mpg123
  85 installed of course.
  86
  87 --enable-ogg123
  88
  89 With this option you can turn on/off support for Ogg Vorbis
  90 soundfiles. This requires ogg123 (Version >= 1.0RC2) and
  91 sox to be installed.
  92
  93 --enable-suidroot
  94
  95 When set, this option sets the setuid bits for the root user when
  96 installing the binary, note that this will require root privileges
  97 upon installation.
  98
  99 ## Other options
 100
 101 --enable-capabilities
 102
 103 Allows running terminatorX suid-root to gain realtime scheduling
 104 (see README.PERFORMANCE).
 105
 106 --with-docdir
 107
 108 If you intend to package terminatorX this flag will allow
 109 terminatorX to find the XML documentation in order to display
 110 it online.
 111
 112 --disable-libxml2
 113
 114 If you've got libxml V2 installed but you want terminatorX to
 115 use V1 instead, use this to disable libxml V1.
 116
 117 --enable-debug
 118
 119 This will cause terminatorX to display some debug messages on
 120 your console.
 121
 122 Step 2: Build the binary
 123 ------------------------
 124
 125 This one's easy:
 126 > make
 127
 128 Step 3: Install the binary
 129 --------------------------
 130
 131 Just as easy:
 132 > make install
 133
 134 Typically you will need root privileges to install in the standard prefix,
 135 if installing as root is not an option you can use the --prefix configure
 136 switch to install to another location.