Project

General

Profile

Building » History » Version 9

John Törnblom, 2013-07-17 17:09

1 1 Adam Sutton
h1. Building
2
3 2 Adam Sutton
h2. Prerequisites
4
5 3 Adam Sutton
Before you can build Tvheadend you will need several packages installed on your development machine. 
6 2 Adam Sutton
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 7 Adam Sutton
$ sudo aptitude install build-essential git pkg-config libssl-dev bzip2 wget
13 2 Adam Sutton
</pre>
14
15
> Optional:
16
<pre>
17 9 John Törnblom
$ sudo aptitude install libavahi-client-dev zlib1g-dev libavcodec-dev libavutil-dev libavformat-dev libswscale-dev
18 2 Adam Sutton
</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 3 Adam Sutton
To compile Tvheadend run:
63 2 Adam Sutton
64
<pre>
65
$ make
66
</pre>
67
68
h2. Installing
69
70 3 Adam Sutton
It is possible to install Tvheadend using make, based on the ./configure options, by running:
71 2 Adam Sutton
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 4 Adam Sutton
NOTE: its VERY important you run test builds from git root, so command should look similar to above.
83
84 3 Adam Sutton
And that you build a [[Packaging|package]] if you wish to install Tvheadend permanently and hook into the system start scripts etc.
85 2 Adam Sutton
86
Use of make install is not very traceable and so removal can sometimes be painful, and it might overwrite an existing installation.
87
88
h2. Packaging
89
90 3 Adam Sutton
For more information about packaging Tvheadend please see [[Packaging|here]]
91 2 Adam Sutton
92
h2. Reporting Problems
93
94 3 Adam Sutton
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]].