4 Copyright (C) 1999-2020 by Alexander König <alex@lisas.de>
5 https://terminatorX.org
10 If you want enhanced audio-file support or optimization don't
11 "quickstart" but read the rest of this file.
13 If you just cant wait any longer try:
17 Step 1: Configure terminatorX
18 -----------------------------
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.
24 if use bash: > export CFLAGS="-O2"
25 with tcsh: > setenv CFLAGS "-O2"
27 Optionally you might want to add additional tuning parameters for
30 All of the following configure options can be either enabled with
31 --enable-option or disabled with --disable-option.
33 The ./configure Options
34 -----------------------
36 ### File support options
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
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.
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
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.
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
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
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
89 With this option you can turn on/off support for Ogg Vorbis
90 soundfiles. This requires ogg123 (Version >= 1.0RC2) and
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
101 --enable-capabilities
103 Allows running terminatorX suid-root to gain realtime scheduling
104 (see README.PERFORMANCE).
108 If you intend to package terminatorX this flag will allow
109 terminatorX to find the XML documentation in order to display
114 If you've got libxml V2 installed but you want terminatorX to
115 use V1 instead, use this to disable libxml V1.
119 This will cause terminatorX to display some debug messages on
122 Step 2: Build the binary
123 ------------------------
128 Step 3: Install the binary
129 --------------------------
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.