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]]. |