summaryrefslogtreecommitdiffstats
path: root/README
blob: 160a4b0a88d32b7089179d0b10a287e6cd7c1b13 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
vdrnfofs
========

Copyright 2010 Tobias Grimm <vdr@e-tobi.net>

vdrnfos is released under the terms of the BSD License - see COPYRIGHT

http://projects.vdr-developer.org/projects/vdrnfofs


What's this about?
------------------

vdrnfofs creates a virtual Fuse-based file system that maps recordings
from the Linux Video Disc Recorder (VDR) to *.nfo and *.mpg files.

Those files can then e.g. be used by media center applications like.
XBMC or Enna.

Such a thing has been tried previously here:

  http://code.google.com/p/vdrfs/

But this project seems to be abandoned, so I've started with vdrnfofs from
scratch.

VDR recordings (PS or TS) are simply mapped 1:1 to *.mpg files. If the VDR
recording is split to multiple files, they are virtually concatenated to a
single *.mpg file.

The *.nfo is a XML file with the follwing structure:

  <movie>
    <title>...</title>
    <plot>...</plot>
  </movie>

Title and plot are mapped from VDR's info file ('T' and 'D').


How to install?
---------------

In order to be able to use vdrnofs, python-setuptools and python-fuse are
required.

If not installing from a package of your preferred Linux distribution run:

  ./setup.py install

The user which should be able to mount vdrnfofs should be a member of the 
group "fuse".


How to use?
-----------

To mount a vdrnfofs file system, run:

  vdrnfofs <mount-point> -o video=<vdr-vide-dir>

e.g.:

   vdrnfofs /mnt/vdrnfofs -o video=/var/lib/video

You can also do this in /etc/fstab with:

   vdrnfofs    /mnt/vdrnfofs   fuse    video=/var/lib/video 0 0

By default only the user that mounted the vdrnfos can also access it.
If you want system-wide access to the file system, you should mount it as root
and pass the option "allow_other" e.g.:

   vdrnfofs /mnt/vdrnfofs -o video=/var/lib/video - o allow_other

If vdrnfofs is not in your path for root (Debian and Ubuntu most likely do not
include /usr/local/bin in the path), you might need to provide the full path
in fstab, like e.g.:

   /usr/local/bin/vdrnfofs    /mnt/vdrnfofs   fuse    video=/var/lib/video 0 0