summaryrefslogtreecommitdiff
path: root/README
blob: 143b9c8a97db3413c1df642596735a2817667f72 (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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
This is a "plugin" for the Video Disk Recorder (VDR).

Copyright (c) 2012, 2013 by Johns.  All Rights Reserved.
Copyright (c) 2013 - 2015 by Maniac.  All Rights Reserved.

License: AGPLv3

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

Description
-----------

vdr-mpv is a fork of the vdr-play plugin from Johns. It uses libmpv for playing
media in VDR and also displays the VDR OSD (On Screen Display) during playback.

Requirements
------------

- VDR version >= 2.2.0 (earlier versions may work, but are untested)
- libmpv >= 0.8.0 (earlier versions may work, but are untested)
- xrandr (only needed for modeline switching)

Installation
------------

- extract the plugin archive and change to the folder
- using "make install" the plugin will be compiled and installed on your system
- adjust the command line arguments to fit your needs

Command line arguments
----------------------

-a audio
  mpv --ao (Default: alsa:device=default)
  The audio out device which is used by mpv, this is directly passed as ao to mpv.

-v video
  mpv --vo (Default: vdpau)
  The video out device which is used by mpv, this is directly passed as vo to mpv.

-h hwdec
  mpv --hwdec-codecs (Default: vdpau)
  The hwdec-codecs which are used by mpv, this is directly passed as hwdec-codecs
  to mpv.

-d device
  optical disc device (Default: /dev/dvd)
  The device which is used for playback of optical media

-l languages
  languages for audio and subtitles (Default: deu,de,ger,eng,en)"
  The default languages choosen for audio and subtitles. Please note since different
  container formats are using different standards you should pass this at least in
  ISO-639-1 (two letters) and 639-2 (three letters). The list is seperated by comma.
  This will is passed as alang and slang to mpv.

-b /dir
  file browser root directory

-r
  switch modeline to refresh rate of played file
  xrandr is needed for this to work. If no xrandr is detected during compile time
  this feature will be deactivated.

Plugin setup options
--------------------

- Hide main menu entry
  Don't show the filebrowser in VDR main menu

- Audio passthrough
  Passthrough digital audio (like AC3, DTS) formats without decoding them
  If passthrough is disabled the VDR volume control is used 

- DTS-HD passthrough
  Passthrough DTS-HD audio, this is only selectable if general passtrough is enabled

- Enable stereo downmix
  Downmix audio to stereo, this is only selectable if passthrough is disabled

- Use prev/next keys for playlist control
  If activated the next and previous keys are used for playlist navigation,
  the keys 7 and 9 are then used for chapter navigation

- Control playlist if no chapters in file
  If a file without chapters is played use the prev/next keys for playlist control

Remote control keys
-------------------

The following remote keys are supported in normal operation (no disc menu active)

Play, Up:               Continue playback if paused
Down, Pause:            Pause playback
Fast rewind:            Seek 10 seconds backwards (fast rew is not supported by mpv)
Fast forward:           Speed up playback speed up to 32 times
Red:                    Time search functionality like used in VDR recordings
Green:                  Seek 60 seconds backwards
Yellow:                 Seek 60 seconds forward
Blue, Stop, Back:       Stop playback
Ok:                     Display current playback status or close status display
                        if currently open
5:                      Open disc nav menu
7:                      Previous playlist item
9:                      Next playlist item
Next:                   Next chapter
Previous:               Previous chapter
Audio:                  Display a menu to switch between the available audio
                        tracks
Subtitles:              Display a menu to switch between the available subtitle
                        tracks

If a disc menu is active the following keys loose their default function described
above and gain the following function

Up, Down, Left, Right:  Navigate through the disc menu
Ok:                     Select the currently highlighted entry in the disc menu
Back:                   Back in the disc nav menu

SVDRP commands
--------------

PLAY filename           play given filename