Project

General

Profile

Building » History » Version 2

Adam Sutton, 2012-08-09 12:27

1 1 Adam Sutton
h1. Building
2
3 2 Adam Sutton
h2. Prerequisites
4
5
Before you can build TVHeadend you will need several packages installed on your development machine. 
6
7
The specific details will vary between distributions so we only cover the major ones here.
8
9
h3. Debian/Ubuntu
10
11
<pre>
12
$ sudo aptitude install build-essential git
13
</pre>
14
15
> Optional:
16
<pre>
17
$ sudo aptitude install libavahi-client-dev
18
</pre>
19
20
h3. Redhat
21
22
TODO: this needs adding
23
24
h3. Gentoo
25
26
TODO: this needs adding
27
28
h2. Get Source
29
30
Next you must obtain the source code, this is hosted on "github":https://github.com/tvheadend/tvheadend.
31
32
To clone the repository simple run the command:
33
34
<pre>
35
$ git clone https://github.com/tvheadend/tvheadend.git
36
</pre>
37
38
h2. Configuring
39
40
TVHeadend comes with a configuration script that allows you to enable/disable optional components and set install paths, etc.
41
42
Most people will be fine with the defaults and can run:
43
44
<pre>
45
$ ./configure
46
</pre>
47
48
However for more advanced options, please run the following:
49
50
<pre>
51
$ ./configure --help
52
</pre>
53
54
And then re-run configure with the required options, i.e.:
55
56
<pre>
57
$ ./configure --enable-transcoder --disable-dvbscan
58
</pre>
59
60
h2. Compiling
61
62
To compile TVHeadend run:
63
64
<pre>
65
$ make
66
</pre>
67
68
h2. Installing
69
70
It is possible to install TVHeadend using make, based on the ./configure options, by running:
71
72
<pre>
73
$ sudo make install
74
</pre>
75
76
However it's recommend that you run from the build directory for development/testing:
77
78
<pre>
79
$ ./build.linux/tvheadend
80
</pre>
81
82
And that you build a [[Packaging|package]] if you wish to install TVHeadend permanently and hook into the system start scripts etc.
83
84
Use of make install is not very traceable and so removal can sometimes be painful, and it might overwrite an existing installation.
85
86
h2. Packaging
87
88
For more information about packaging TVHeadend please see [[Packaging|here]]
89
90
h2. Reporting Problems
91
92
If you have problems with a custom compiled version of TVHeadend its important that any issue reports include details of the specific version of source you used. For more details please see [[bugreporting|here]].