File: INSTALL

package info (click to toggle)
terminatorx 4.0.1-2
  • links: PTS, VCS
  • area: main
  • in suites: buster, sid
  • size: 4,344 kB
  • sloc: cpp: 13,085; ansic: 3,738; sh: 1,263; makefile: 128; xml: 113; awk: 3
file content (136 lines) | stat: -rw-r--r-- 3,760 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
terminatorX INSTALL
===================

Copyright (C) 1999-2016 by Alexander K├Ânig <alex@lisas.de>
https://terminatorX.org

Quickstart
----------

If you want enhanced audio-file support or optimization don't
"quickstart" but read the rest of this file.

If you just cant wait any longer try:
> ./configure
> make install

Step 1: Configure terminatorX
-----------------------------

If you want your compiler to optimize the binary, you need to set your
environment variable CFLAGS to your needs BEFORE you run ./configure.

for example:
if use bash: > export CFLAGS="-O2"
with tcsh:   > setenv CFLAGS "-O2"

Optionally you might want to add additional tuning parameters for
your target platform.

All of the following configure options can be either enabled with
--enable-option or disabled with --disable-option.

The ./configure Options
-----------------------

### File support options

All of these are enabled by default. Nevertheless the configure
script checks for the availability of the helper application
and if it's not found disables support for it. Check the
terminatorX homepage for links to those apps if you don't have
them - or check your distribution first, AFAIK all bring these
tools nowaday.

--enable-mad

This will make terminatorX use the MPEG Audio Decoder library if
it's detected. This allows terminatorX to load mp3 files
significantly faster than with the mpg123 method. Additionally
terminatorX will find out about the sampling rate of an mp3 file
and adjust the playback speed accordingly.

--enable-vorbis

This will make terminatorX use the OGG Vobris libraries to load
OGG files directly. This method has the same advantages over
loading through ogg123 as the "mad" method has over loading
through mpg123.

--enable-audiofile

This enables the use of libaudiofile on loading audio files.
The library supports a wide range of common audio file formats
(eg WAV/AIFF/AU etc) therefor its use highly recommended.

--enable-wav

This enables the builtin wav routines. They load 16Bit/44Khz
MONO RIFF/WAV files only but they do that significantly faster
than using sox. If these routines fail and sox support is
enabled, terminatorX will try to load the file with sox as
a fallback. Disable them only if they don't load your files
correctly.

--enable-sox

This enables sox support. As sox can load nearly any audio file
it makes sense to use it. You have to have sox installed of
course.

--enable-mpg123

This enables mpg123 support. If you want to be able to load mp3
files keep this option enabled. You have to have mpg123
installed of course.

--enable-ogg123

With this option you can turn on/off support for Ogg Vorbis
soundfiles. This requires ogg123 (Version >= 1.0RC2) and
sox to be installed.

--enable-suidroot

When set, this option sets the setuid bits for the root user when
installing the binary, note that this will require root privileges
upon installation.

## Other options

--enable-capabilities

Allows running terminatorX suid-root to gain realtime scheduling
(see README.PERFORMANCE).

--with-docdir

If you intend to package terminatorX this flag will allow
terminatorX to find the XML documentation in order to display
it online.

--disable-libxml2

If you've got libxml V2 installed but you want terminatorX to
use V1 instead, use this to disable libxml V1.

--enable-debug

This will cause terminatorX to display some debug messages on
your console.

Step 2: Build the binary
------------------------

This one's easy:
> make

Step 3: Install the binary
--------------------------

Just as easy:
> make install

Typically you will need root privileges to install in the standard prefix,
if installing as root is not an option you can use the --prefix configure
switch to install to another location.