UBUNTU/Installation: Difference between revisions

From VDR Wiki
Jump to navigation Jump to search
m (save)
No edit summary
 
(32 intermediate revisions by 7 users not shown)
Line 1: Line 1:
= Tips for Installing VDR on Ubuntu =
= Install and Configure VDR on Ubuntu (outdated!) =
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 its first release.
VDR has been available in the Ubuntu Universe repository since Warty.
* [http://packages.ubuntu.com/vdr Ubuntu Packages]
* [http://packages.ubuntu.com/vdr Ubuntu Packages]
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 [http://help.ubuntu.com/community/Repositories add the Universe repository to your Apt sources list]. Now you can use Aptitude or Synaptic to search for available vdr packages. eg.
Before you can install VDR packages, you must first [http://help.ubuntu.com/community/Repositories add the Universe repository to your Apt sources list]. Now you can use Aptitude or Synaptic to search for available vdr packages.
* See [[DEBIAN_VDR_Packages]] for further information.
<pre>richard@lazar:~$ aptitude search ^vdr
p vdr - Video Disk Recorder for DVB cards
v vdr-daemon -
id vdr-dev - Video Disk Recorder for DVB cards
v vdr-kbd -
v vdr-lirc -
p vdr-plugin-bitstreamout - Plugin to vdr for playing AC3-Sound via yo
p vdr-plugin-console - Plugin for vdr that implements a virtual t
p vdr-plugin-dvd - Plugin to vdr for playing DVD's
p vdr-plugin-examples - Plugins for vdr to show some possible feat
p vdr-plugin-femon - DVB frontend status monitor plugin for vdr
p vdr-plugin-freecell - Plugin to vdr that implements the card gam
p vdr-plugin-games - Plugin to vdr for playing tetris, snake an
p vdr-plugin-mp3 - Plugin to vdr for playing mp3's
p vdr-plugin-osdteletext - Teletext plugin for vdr
p vdr-plugin-prefermenu - Plugin that implements a preferred channel
p vdr-plugin-remote - Plugin for vdr to support the built-in rem
p vdr-plugin-sky - Plugin for using a Sky Digibox with vdr
p vdr-plugin-vcd - Plugin to vdr for playing (S)VCD's
p vdr-plugin-weather - Weather plugin for vdr
v vdr-rcu -
p vdradmin - Web-based administration tool for vdr
</pre>

* If you have a fully featured DVB card (one with a builtin MPEG decoder chip) then these packages will probably be all you need to get started. Use Aptitude or Synaptic to install the base "vdr" package and then skip to the [[UBUNTU/Installation#Configuration|configuration section]]
* If on the other hand you have bought a so called budget DVB card, there is more work to be done. Read the next section.


== 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.list
Instead of simply installing the standard binary packages described above you can instead compile your own packages using Debian packaging tools and sources from [http://pkg-vdr-dvb.alioth.debian.org/ the Debian VDR and DVB Packaging Project]. This way you get a greater selection of and much more up to date versions of VDR packages plus easy package installation, setup, and if necessary removal.
* Continue to [[DEBIAN_Compiling_VDR_Source_Packages]]

If you have a budget DVB card and need to use a software decoder plugin such as xinelibout or the DXR3 MPEG decoding device plugin, this section may be particularly usefule to you.

First read [http://pkg-vdr-dvb.alioth.debian.org/] and then follow the instructions below.
* Install svn-buildpackage and its dependencies. This lives in the Ubuntu Universe repository, so if you haven't already done so, add Universe to your sources.lst
<pre>
richard@lazar:~$ sudo aptitude install svn-buildpackage
Password:
Reading package lists... Done
...etc...
</pre>
* Tell svn-buildpackage where to put compiled packages and where to find source tarballs.
<pre>
richard@lazar:~$ echo "svn-override=buildArea=${HOME}/src/debian-vdr/build-area,origDir=${HOME}/src/debian-vdr/tarballs" > .svn-buildpackage.conf
</pre>
* Setup a folder to do the package building in.
<pre>
richard@lazar:~$ mkdir -p src/debian-vdr
richard@lazar:~$ cd src/debian-vdr/
richard@lazar:~/src/debian-vdr$
</pre>
* Check out the tarballs. There are alot of them and some are quite large, so this may take a long time.
<pre>
richard@lazar:~/src/debian-vdr$ svn co svn://svn.debian.org/svn/pkg-vdr-dvb/tarballs
A tarballs/vdr-plugin-nordlichtsepg_0.8a.orig.tar.gz
A tarballs/vdr-plugin-osdtest256_0.1.0.orig.tar.gz
A tarballs/vdr-plugin-freecell_0.0.2.orig.tar.gz
A tarballs/vdr-plugin-xine_0.7.9.orig.tar.gz
...etc...
</pre>
* Check out the debian build scripts.
<pre>
richard@lazar:~/src/debian-vdr$ svn co svn://svn.debian.org/svn/pkg-vdr-dvb/vdr/vdr/trunk vdr/vdr
A vdr/vdr/debian
A vdr/vdr/debian/control
A vdr/vdr/debian/config-loader.sh
...etc...
</pre>
* Start compiling the package
<pre>
richard@lazar:~/src/debian-vdr$ cd vdr/vdr/
richard@lazar:~/src/debian-vdr/vdr/vdr$ svn-buildpackage -rfakeroot -uc -us
Imported config directives:
--svn-override=buildArea=/home/richard/src/debian-vdr/build-area,origDir=/home/richard/src/debian-vdr/tarballs
trunkDir: /home/richard/src/debian-vdr/vdr/vdr
trunkUrl: svn://svn.debian.org/svn/pkg-vdr-dvb/vdr/vdr/trunk
dpkg-checkbuilddeps
dpkg-checkbuilddeps: Unmet build dependencies: libcap-dev
Insufficient Build-Deps, stop!
</pre>
You will very likely see something like this telling you that you need to install dependencies. So do that and retry.
<pre>
richard@lazar:~/src/debian-vdr/vdr/vdr$ sudo aptitude install libcap-dev
Password:
...etc...
</pre>
* If all went well, you should see...
<pre>
...etc..
build command was successful; binaries are in /home/richard/src/debian-vdr/build-area/. The changes file is:
/home/richard/src/debian-vdr/build-area/vdr_1.4.1-1_i386.changes
Binary packages:
/home/richard/src/debian-vdr/build-area/vdr-dev_1.4.1-1_all.deb /home/richard/src/debian-vdr/build-area/vdr_1.4.1-1_i386.deb /home/richard/src/debian-vdr/build-area/vdr-plugin-sky_1.4.1-1_i386.deb /home/richard/src/debian-vdr/build-area/vdr-plugin-examples_1.4.1-1_i386.deb
rm -rf /home/richard/src/debian-vdr/build-area/vdr-1.4.1
richard@lazar:~/src/debian-vdr/vdr/vdr$
</pre>
* Finally install the packages.
<pre>
richard@lazar:~/src/debian-vdr/vdr/vdr$ cd ../../build-area/
richard@lazar:~/src/debian-vdr/build-area$ ls
vdr_1.4.1-1.diff.gz vdr_1.4.1.orig.tar.gz
vdr_1.4.1-1.dsc vdr-dev_1.4.1-1_all.deb
vdr_1.4.1-1_i386.changes vdr-plugin-examples_1.4.1-1_i386.deb
vdr_1.4.1-1_i386.deb vdr-plugin-sky_1.4.1-1_i386.deb
richard@lazar:~/src/debian-vdr/build-area$ sudo dpkg -i vdr_1.4.1-1_i386.deb vdr-dev_1.4.1-1_all.deb
</pre>
* You will be prompted about:
** DVB kernel modules (in my experience DVB modules are automatically loaded)
** Default recordings directory (it recommends /var/lib/video.00 and asks to create it, I always say no and manually create a /srv/vdr folder, it's up to you)
** Choose your card type
== Configuration ==
* Try running vdr. The default Video directory is not writable by my user so while we are testing vdr we ask it to use /tmp for video files. You may see a message "please turn off UTF-8 before starting VDR". If so try defining the LANG environment variable:
<pre>
richard@lazar:~$ LANG=c vdr -v /tmp
vdr: error while reading '/var/lib/vdr/channels.conf'
</pre>
You may see this error (at least I did) and it means that the channels.conf file is somehow corrupt. You need to channels.conf update the channels.conf anyway; it must be tailored to your DVB type (ie DVB-C, DVB-S, DVB-T) and if you are using DVB-T the frequencies depend on your local transmitter.
To make a channels.conf use the 'scan' commandline tool, which is part of the dvb-utils package. In my case (DVB-T in the Midlands, UK) I use:
<pre>
richard@vito:/var/lib/vdr$ scan -o vdr /usr/share/doc/dvb-utils/examples/scan/dvb-t/uk-SuttonColdfield > /tmp/channels.conf
richard@vito:/var/lib/vdr$ sudo mv /tmp/channels.conf ./
</pre>
...replace dvb-t/uk-SuttonColdfield with whatever is appropriate for your area.

Having done that, you should be able to run vdr from the command line.
<pre>
richard@vito:~$ LANG="c" vdr -v /tmp
vdr: no primary device found - using first device!
</pre>
...well it runs, but if you're using a budget card, it has no way of displaying the picture.

Before moving on, and now that we know that vdr is able to run, lets set it up to run as a service. Open /etc/default/vdr in you editor of choice and add 'export LANG="c"' at the top and set ENABLED=1. Mine looks like this:
<pre>
richard@vito:~$ sudo nano -w /etc/default/vdr
</pre>
<pre>
# /etc/default/vdr
#
# See also /usr/share/doc/README.Debian
#


== Configuring VDR and plugins ==
export LANG="c"
* See [[DEBIAN_Configuring_VDR]]


== Installing VDR from e-tobi.net source packages ==
# Change to 1 to enable vdr's init-script
* updated 5/2007 (VA, Finland)
ENABLED=1
* 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.*<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


$ cd ~/vdr-src
# Change this to 1 if you want vdr to be able to shutdown the
$ apt-get source vdr-plugin-subtitles
# computer
$ sudo apt-get build-dep vdr-plugin-subtitles
ENABLE_SHUTDOWN=0
$ 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.


# Options that will be passed to vdr's commandline
# for example: OPTIONS="-w 15"
OPTIONS="-w 60"


<!-- [[Category:Ubuntu]] -->
VIDEO_DIR="/srv/vdr"
[[Category:CandidateForDeletion]]
</pre>
If you choose to use a different video directory than the one recommended at installation, you'll have to create it and change its owner to vdr:vdr.
<pre>
richard@lazar:~/src/debian-vdr/build-area$ sudo mkdir -p /srv/vdr
richard@lazar:~/src/debian-vdr/build-area$ sudo chown -R vdr:vdr /srv/vdr
</pre>

Latest revision as of 18:52, 7 December 2013

Install and Configure VDR on Ubuntu (outdated!)

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.