Building » History » Version 4
Adam Sutton, 2012-08-12 00:59
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 | $ 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 | 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]]. |