File: README

package info (click to toggle)
vdr-plugin-console 0.5.1-16
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 324 kB
  • ctags: 353
  • sloc: ansic: 6,668; sh: 109; makefile: 100
file content (84 lines) | stat: -rw-r--r-- 4,077 bytes parent folder | download
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
This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Jan Rieger <jan@ricomp.de>

Project's homepage:          http://RiComp.de/vdr

Latest version available at: http://RiComp.de/vdr

See the file COPYING for license information.
----------------------------------------------------------------------



Description:
----------------------------------------------------------------------
Your  TV  screen  and a keyboard  that  are  connected to a VDR box  are
building a terminal. With this terminal you can manage several consoles.
In the OSD  of VDR you can  open as many  consoles as you want. In  each
console you can start a program that runs in the background. Your inputs
to the keyboard are  redirected to the current  selected console as well
as the output that these  programs generate are redirected into the OSD.

With this setup you can look after some things that you want to know but
have no entry in the commands.conf file for that without the necessarity
to connect a  monitor to  your box or  make a network connection from an
other computer with telnet or ssh.
Also you can  run longer tasks such as  converting a movie and you won't
VDR to shutdown itself until the conversion is completed.
Note: This feature  is not implemented up to now  because of the lack in
      the plugin interface.



Operation Manual
----------------------------------------------------------------------
To use the  console plugin you have to  compile the plugin and start VDR
with the "-Pconsole" switch as you needed to do with every other plugin.

Once  the plugin is  installed  you can see  the entry 'Consoles' in the
main  menu of  VDR. By  activating this entry  with the key OK you get a
list of all actually opened consoles.  In the first time  after starting
VDR this list  should be empty.  You can  create a new console  with the
red key.  By doing this the new  console is also  opened for you and you
can begin to work immediately.

In  the console  window:  With the  green and yellow  keys you  can leaf
through the  (at that moment not visible)  console list.  With  the blue
key you can  "Terminate" the process after a  confirmation if you really
want to do so;  Or if it already  has quitted then  you  can "Close" the
console.  In each case the current console window will be closed and you
come back to the console list in wich the closed console is gone.

Back to the console list:  Some of the consoles in the list are running,
others  are quitted.  The  quitted  ones are  shown  with  the  appendix
"stopped".  Stopped consoles  are shown until you close them explicitly,
so you can look for the  output of longer  running tasks without having
to watching  them.  The blue  key  has  here the  same  meaning as in an
console window.

If you use your  keyboard both as  remote control  and as keyboard for a
console then  you have  to note  that a  console  window  for a  running
process  captures the keyboard  for console  input  automatically.  This
mode will be indicated by an "K"  symbol in the  title bar. In this mode
you can  not  control VDR with the usual  keys.  To leave this  mode you
have to quit  the process or you can  press the {ESC} key.  In this case
you  will be asked  if you  want to  leave the  keyboard  mode.  You can
answer this  question with  the "OK" key.  When the "K"  disappears  and
you have  back the control over VDR.  To reenter the keyboard mode: only
press the OK key. If you have  cancelled the question to leave, when the
original key  stroke {ESC} will be sent  to the process.  So you can use
this key in an application, too.

Miscellaneous:
If a process  creates the bell signal  when you hear the  signal at once
and the "B" sign will be shown in  the title bar of the  console window.
If  you  don't  have the  corresponding  console  open  then it  will be
showed in the  console list.  As soon as you  have seen a  signal,  that
signal disappears.


Final
----------------------------------------------------------------------
And now have much fun with this plugin :-)