Difference between revisions of "UBUNTU/Installation"

From VDR Wiki
Jump to: navigation, search
m (link to DEBIAN_Configuring_VDR)
(Installing VDR from e-tobi.net source packages)
(14 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
= Install and Configure VDR on Ubuntu =
 
= Install and Configure VDR on Ubuntu =
This article contains tips and advice for setting up VDR and plugins on Ubuntu. Ubuntu releases are based on snapshots of Debian Unstable; therefore the following may be of use to Debian users too. Indeed, later in this article we show how to compile bleading edge versions of the VDR packages from the [http://pkg-vdr-dvb.alioth.debian.org/ Debian VDR and DVB Packaging Project].
+
This article contains tips and advice for setting up VDR and plugins on Ubuntu.  
 +
{{Box Info |
 +
Ubuntu releases are based on snapshots of Debian Unstable so you can mostly refer to the [[:Category:Debian|Debian documentation]].
 +
}}
 
== Installing from Binary Packages ==
 
== Installing from Binary Packages ==
 
VDR has been available in the Ubuntu Universe repository since Warty.  
 
VDR has been available in the Ubuntu Universe repository since Warty.  
Line 10: Line 13:
  
 
== Installing from Debian Package Sources ==
 
== Installing from Debian Package Sources ==
* You will need to install '''svn-buildpackage''', which lives in the Ubuntu Universe repository, so if you haven't already done so, add Universe to your sources.lst
+
* You will need to install '''svn-buildpackage''', which lives in the Ubuntu Universe repository, so if you haven't already done so, add Universe to your sources.list
 
* Continue to [[DEBIAN_Compiling_VDR_Source_Packages]]
 
* Continue to [[DEBIAN_Compiling_VDR_Source_Packages]]
  
== Configuring VDR ==
+
== Configuring VDR and plugins ==
 
* See [[DEBIAN_Configuring_VDR]]
 
* See [[DEBIAN_Configuring_VDR]]
  
= Install and Configure VDR Plugins on Ubuntu =
+
== Installing VDR from e-tobi.net source packages ==  
If you have chosen to compile packages from source (as described above) you may now want to compile some of the plugin packages in the same way. You will already have checked out all the original tarballs, so all that remains is to checkout the debian build scripts for each plugin that you are interested, compile with svn-buildpackage and install with dpkg.
+
* updated 5/2007 (VA, Finland)
 
+
* Jul 29. 2007 - updated the deb-src line (NM, Finland)
You can see which plugins are available for compiling by listing the tarball folder or by [http://svn.debian.org/wsvn/pkg-vdr-dvb/vdr/?rev=0&sc=0 browsing the websvn interface].
+
 
   
 
   
Having installed the plugin package you can configure it according to the generic information available in the README files in /usr/share/doc/vdr-plugin-* or [[Plugins|elsewhere on this wiki]].
+
IMPORTANT INFO BEFORE INSTALLATION!!
 +
* this is only recommended if Ubuntu supplied packages are not enough, for example you need extra plugins
 +
* make sure your DVB card works before doing this (I used kaffeine player for testing)
 +
* tested on Ubuntu Edgy/Feisty, recommended only for advanced users!!
 +
* this example includes subtitles patch (needed for DVB subtitles at least in some European countries)
 +
* this process must be done again after dist-upgrades
 +
 +
VDR
 +
1. Remove all installed Ubuntu VDR packages.
 +
$ sudo apt-get remove vdr vdr-dev
 +
* NOTE this does not remove configuration files, consider using Synaptic complete removal
 +
 +
2. Add the following to /etc/apt/sources.list.
 +
deb-src http://e-tobi.net/vdr-experimental lenny base addons vdr-multipatch
 +
 +
3. Update packagelist and install compile tools.
 +
$ sudo apt-get update
 +
$ sudo apt-get install dpkg-dev build-essential fakeroot
 +
 +
3. Make a directory for source code files.
 +
$ cd ~
 +
$ mkdir vdr-src
 +
$ cd vdr-src
 +
 +
4. Install VDR sourcecode.
 +
  $ apt-get source vdr
 +
 +
5. Try to get depencies automatically.
 +
$ sudo apt-get build-dep vdr
 +
 +
6. Make sure you have some needed packages.
 +
$ sudo apt-get install debhelper linux-headers-generic libjpeg62-dev dpatch libcap-dev libncurses5-dev
 +
 +
7. Activate subtitles patch by editing file vdr-1.4.*/debian/patches/00list.
 +
Do this only if you need DVB subtitles. Remove comments from the following lines.
 +
opt-27_subtitles-ttxtsubs
 +
opt-27-x_subtitles-ttxtsubs-volumebar-fix
 +
 +
You can also activate other patches, but be careful as they might conflict each other.
 +
 +
8. Compile VDR and create deb packages.
 +
 +
$ cd ~/vdr-src/vdr-1.4.*<br>
 +
$ fakeroot debian/rules binary
 +
 +
After this there should be vdr_1.4.*.deb and vdr-dev_1.4.*.deb packages in ~/vdr-src.
 +
 +
9. Install deb packages.
 +
 +
$ cd ~/vdr-src<br>
 +
$ sudo dpkg -i vdr_1.4*.deb vdr-dev_1.4*.deb
 +
$ sudo /etc/init.d/vdr stop
 +
(stop vdr, plugins need to be activated)
 +
 +
DONE! Continue to install plugins below.
 +
 +
PLUGINS
 +
 +
Browse e-tobi.net selection at http://www.e-tobi.net/repositories/repositories.html
 +
Below are a couple of examples to install them.
 +
 +
vdr-plugin-subtitles
  
I will give details of compiling the Xineliboutput plugin because it is one that I have some experience with and one that anyone using a budget DVB card should try. Other options for budget card users are:
+
$ cd ~/vdr-src
* '''vdr-plugin-dxr3''': See [[Dxr3-plugin]] (If you have a DXR3 hardware MPEG decoder card)
+
$ apt-get source vdr-plugin-subtitles
* '''vdr-plugin-softdevice''': See [[Softdevice-plugin]]
+
$ sudo apt-get build-dep vdr-plugin-subtitles
* '''vdr-plugin-streamdev''': See [[Streamdev-plugin]]
+
$ cd vdr-plugin-subtitles-*
* '''vdr-plugin-xine''': See [[Xine-plugin]] (note this different to the xineliboutput plugin below, although similar idea)
+
$ fakeroot debian/rules binary
 
+
$ cd ..
== Compile and Install Xineliboutput Plugin ==
+
$ sudo dpkg -i vdr-plugin-subtitles_*.deb
The [http://users.tkk.fi/~phintuka/vdr/vdr-xineliboutput/ Xineliboutput plugin] allows you to render both DVB MPEG stream and the VDR OSD using libxine and processing power of your CPU. If you have a budget DVB card and your computer is powerful enough Xinelibout may be ideal for you. Additionally, it can stream the video and OSD across a LAN which allows you to setup a headless VDR server (using modest hardware) while the picture is displayed on and control is handled by one or more client machines elsewhere on the LAN.
+
 
+
vdr-plugin-xineliboutput
Xineliboutput is not available in any of the Ubuntu repositories so we compile it from the latest Debian Package Sources as described above in the section [[UBUNTU/Installation#Installing from Debian Package Sources|Installing from Debian Package Sources]]. Briefly:
+
<pre>
+
$ apt-get source vdr-plugin-xineliboutput
richard@vito:~/src/debian-vdr$ svn co svn://svn.debian.org/svn/pkg-vdr-dvb/vdr/vdr-plugin-xineliboutput/trunk vdr/vdr-plugin-xineliboutput
+
$ sudo apt-get build-dep vdr-plugin-xineliboutput
</pre>
+
$ cd vdr-plugin-xineliboutput-*
<pre>
+
$ fakeroot debian/rules binary
richard@vito:~/src/debian-vdr$ cd vdr/vdr-plugin-xineliboutput/
+
$ cd ..
richard@vito:~/src/debian-vdr/vdr/vdr-plugin-xineliboutput$ svn-buildpackage -rfakeroot -uc -us
+
$ sudo dpkg -i vdr-plugin-xineliboutput_*.deb libxine-xvdr_*.deb libxineliboutput-sxfe_*.deb xineliboutput-sxfe_*.deb
</pre>
+
<pre>
+
MORE PLUGINS
richard@vito:~/src/debian-vdr/vdr/vdr-plugin-xineliboutput$ cd ../../build-area/
+
richard@vito:~/src/debian-vdr/build-area$ ls *.deb
+
Below are listed a couple of useful plugins. Install the same way as above.  
libxine-xvdr_0.99rc4-1_i386.deb
+
It can be wise to install these after you are sure vdr is working.
vdr_1.4.1-1_i386.deb
+
vdr-plugin-remote (remote control support)
vdr-dev_1.4.1-1_all.deb
+
vdr-plugin-osdteletext (used at least in europe)
vdr-plugin-examples_1.4.1-1_i386.deb
+
vdradmin-am (control vdr via web)
vdr-plugin-sky_1.4.1-1_i386.deb
+
vdr-plugin-xineliboutput_0.99rc4-1_i386.deb
+
USEFUL TIPS
vdr-plugin-xineliboutput-fb_0.99rc4-1_i386.deb
+
vdr-plugin-xineliboutput-x_0.99rc4-1_i386.deb
+
Starting VDR (started automatically during deb installation)
xineliboutput-remote-fb_0.99rc4-1_i386.deb
+
$ sudo /etc/init.d/vdr start
xineliboutput-remote-x_0.99rc4-1_i386.deb
+
</pre>
+
Config files (if you make changes, remember to restart VDR)
<pre>
+
richard@vito:~/src/debian-vdr/build-area$ sudo dpkg -i *xine*.deb
+
/etc/default/vdr
</pre>
+
# Enable VDR
This will install the vdr plugin plus the lightweight client apps for X11 and fb, plus a xine plugin which allows you to connect to the VDR stream from standard xine-ui.
+
ENABLED=1
== Configure Xineliboutput Plugin and Player ==
+
# change default path to save recordings
If Xinelibout installed without problems, you now have to configure it.  
+
VIDEO_DIR="/path/to/videodir"
* First read the README files.
+
# use this only to configure remote control keys via sxfe, comment out for normal use
<pre>
+
# USER=your_username_which_is_running_X_session
richard@vito:~$ less /usr/share/doc/vdr-plugin-xineliboutput/README.gz
+
</pre>
+
/etc/vdr/plugins/plugin.xineliboutput.conf
All the information you need to configure the plugin is in that README and in the configuration file its self.
+
--local=none # disable sxfe access, consider enabling if you have a dedicated VDR box
Debian VDR Plugin configurations live in /etc/vdr/plugins. In this case:
+
--remote=37890 # add network support in order to access it via xine player
<pre>
+
--primary
richard@vito:~$ sudo nano -w /etc/vdr/plugins/plugin.xineliboutput.conf
+
NOTE, first time starting VDR use --local=sxfe --remote=none to configure remote control keys.
</pre>
+
Remember to use correct USER above (normally VDR is run as "vdr" user which does not have access to your X session)
For general information on installing and configuring this plugin see [[Xineliboutput-plugin]].
+
Otherwise xine xvdr access does not seem to work because it's waiting for remote control configuration.
== Compile the Xine-ui Source Package to Enable VDR Keys ==
+
Also temporarily "chmod 777 /var/lib/vdr" so that remote.conf can be written.
Using xine-ui gives you many features which are not available in the lightweight clients eg Zooming and allows you to easily switch to DVD playback with full menus.  
+
 +
/var/lib/vdr/channels.conf
 +
This is a required file with channel frequency info in your area.
 +
See http://www.linuxtv.org/vdrwiki/index.php/Syntax_of_channels.conf for more info.
 +
 +
DONE!!
 +
 +
You should be able to access VDR via xine-ui (select XVDR). See xineliboutput for more frontends.
 +
If you have later problems to use xine-ui, try the sxfe option (mentioned earlier) to debug.
  
Unfortunately the stock Ubuntu Dapper xine-ui is not compiled with the necessary --enable-vdr-keys flag which enables full control of VDR. But it is not difficult to recompile xine-ui from the source packages. First glance at [http://www.murrayc.com/blog/permalink/2006/04/21/building-modified-debian-packages/ this guide to recompiling Debian packages] then follow these steps:
 
* Install all build dependencies
 
<pre>
 
richard@lazar:~/src/debian-xine/xine-ui-0.99.4$ sudo apt-get build-dep xine-ui
 
</pre>
 
* Download the xine-ui source package
 
<pre>
 
richard@lazar:~/src/debian-xine/xine-ui-0.99.4$ apt-get source xine-ui
 
</pre>
 
* Update the debian/rules file
 
<pre>
 
richard@lazar:~/src/debian-xine/xine-ui-0.99.4$ nano -w debian/rules
 
</pre>
 
<pre>
 
configure: configure-stamp
 
configure-stamp:
 
        dh_testdir
 
        ./configure --prefix=/usr --mandir=\$${prefix}/share/man \
 
                        --enable-vdr-keys \
 
...
 
</pre>
 
* Update the changelog file
 
<pre>
 
richard@lazar:~/src/debian-xine/xine-ui-0.99.4$ dch --nmu
 
</pre>
 
<pre>
 
xine-ui (0.99.4-0ubuntu6.1) dapper; urgency=low
 
  
  * Non-maintainer upload.
 
  * Added --enable-vdr-keys
 
...
 
</pre>
 
* Build the package.
 
<pre>
 
richard@lazar:~/src/debian-xine/xine-ui-0.99.4$ debuild -us -uc
 
</pre>
 
* And install
 
<pre>
 
richard@lazar:~/src/debian-xine/xine-ui-0.99.4$ sudo dpkg -i ../xine-ui_0.99.4-0ubuntu6.1_i386.deb
 
</pre>
 
 
[[Category:Ubuntu]]
 
[[Category:Ubuntu]]

Revision as of 18:41, 19 August 2009

Install and Configure VDR on Ubuntu

This article contains tips and advice for setting up VDR and plugins on Ubuntu.

Info
Info

Ubuntu releases are based on snapshots of Debian Unstable so you can mostly refer to the Debian documentation.

Installing from Binary Packages

VDR has been available in the Ubuntu Universe repository since Warty.

This article assumes that you have installed Ubuntu Dapper and have installed and confirmed to be working a Linux compatible DVB device.

Before you can install VDR packages, you must first add the Universe repository to your Apt sources list. Now you can use Aptitude or Synaptic to search for available vdr packages.

Installing from Debian Package Sources

  • You will need to install svn-buildpackage, which lives in the Ubuntu Universe repository, so if you haven't already done so, add Universe to your sources.list
  • Continue to DEBIAN_Compiling_VDR_Source_Packages

Configuring VDR and plugins

Installing VDR from e-tobi.net source packages

* updated 5/2007 (VA, Finland)
* Jul 29. 2007 - updated the deb-src line (NM, Finland)

IMPORTANT INFO BEFORE INSTALLATION!!
* this is only recommended if Ubuntu supplied packages are not enough, for example you need extra plugins
* make sure your DVB card works before doing this (I used kaffeine player for testing)
* tested on Ubuntu Edgy/Feisty, recommended only for advanced users!!
* this example includes subtitles patch (needed for DVB subtitles at least in some European countries)
* this process must be done again after dist-upgrades

VDR
1. Remove all installed Ubuntu VDR packages.
$ sudo apt-get remove vdr vdr-dev
* NOTE this does not remove configuration files, consider using Synaptic complete removal

2. Add the following to /etc/apt/sources.list.
deb-src http://e-tobi.net/vdr-experimental lenny base addons vdr-multipatch

3. Update packagelist and install compile tools.
$ sudo apt-get update
$ sudo apt-get install dpkg-dev build-essential fakeroot

3. Make a directory for source code files.
$ cd ~
$ mkdir vdr-src
$ cd vdr-src

4. Install VDR sourcecode.
 $ apt-get source vdr

5. Try to get depencies automatically.
$ sudo apt-get build-dep vdr

6. Make sure you have some needed packages.
$ sudo apt-get install debhelper linux-headers-generic libjpeg62-dev dpatch libcap-dev libncurses5-dev

7. Activate subtitles patch by editing file vdr-1.4.*/debian/patches/00list.
Do this only if you need DVB subtitles. Remove comments from the following lines.
opt-27_subtitles-ttxtsubs
opt-27-x_subtitles-ttxtsubs-volumebar-fix

You can also activate other patches, but be careful as they might conflict each other.

8. Compile VDR and create deb packages.

$ cd ~/vdr-src/vdr-1.4.*
$ fakeroot debian/rules binary After this there should be vdr_1.4.*.deb and vdr-dev_1.4.*.deb packages in ~/vdr-src. 9. Install deb packages. $ cd ~/vdr-src
$ sudo dpkg -i vdr_1.4*.deb vdr-dev_1.4*.deb $ sudo /etc/init.d/vdr stop (stop vdr, plugins need to be activated) DONE! Continue to install plugins below. PLUGINS Browse e-tobi.net selection at http://www.e-tobi.net/repositories/repositories.html Below are a couple of examples to install them. vdr-plugin-subtitles
$ cd ~/vdr-src
$ apt-get source vdr-plugin-subtitles
$ sudo apt-get build-dep vdr-plugin-subtitles
$ cd vdr-plugin-subtitles-*
$ fakeroot debian/rules binary
$ cd ..
$ sudo dpkg -i vdr-plugin-subtitles_*.deb

vdr-plugin-xineliboutput

$ apt-get source vdr-plugin-xineliboutput
$ sudo apt-get build-dep vdr-plugin-xineliboutput
$ cd vdr-plugin-xineliboutput-*
$ fakeroot debian/rules binary
$ cd ..
$ sudo dpkg -i vdr-plugin-xineliboutput_*.deb libxine-xvdr_*.deb libxineliboutput-sxfe_*.deb xineliboutput-sxfe_*.deb

MORE PLUGINS

Below are listed a couple of useful plugins. Install the same way as above. 
It can be wise to install these after you are sure vdr is working.
vdr-plugin-remote (remote control support)
vdr-plugin-osdteletext (used at least in europe)
vdradmin-am (control vdr via web)

USEFUL TIPS

Starting VDR (started automatically during deb installation)
$ sudo /etc/init.d/vdr start

Config files (if you make changes, remember to restart VDR)

/etc/default/vdr
# Enable VDR
ENABLED=1
# change default path to save recordings
VIDEO_DIR="/path/to/videodir" 
# use this only to configure remote control keys via sxfe, comment out for normal use
# USER=your_username_which_is_running_X_session

/etc/vdr/plugins/plugin.xineliboutput.conf
--local=none # disable sxfe access, consider enabling if you have a dedicated VDR box
--remote=37890 # add network support in order to access it via xine player
--primary
NOTE, first time starting VDR use --local=sxfe --remote=none to configure remote control keys.
Remember to use correct USER above (normally VDR is run as "vdr" user which does not have access to your X session)
Otherwise xine xvdr access does not seem to work because it's waiting for remote control configuration.
Also temporarily "chmod 777 /var/lib/vdr" so that remote.conf can be written.

/var/lib/vdr/channels.conf
This is a required file with channel frequency info in your area.
See http://www.linuxtv.org/vdrwiki/index.php/Syntax_of_channels.conf for more info.

DONE!!

You should be able to access VDR via xine-ui (select XVDR). See xineliboutput for more frontends.
If you have later problems to use xine-ui, try the sxfe option (mentioned earlier) to debug.