tvpsh


Table of Contents

tvpvrd — Command line shell to interface tvpvrd daemon

Name

tvpsh — Command line shell to interface tvpvrd daemon

Synopsis

tvpsh [options...]

Description

The tvpsh(1) is a command line shell meant to interface the tvpvrd daemon. The program offers full command line editing (emulating emacs command set) as well as history. This makes it the preferred way to inteface with the daemon for the full feature set. The alternative command line way is to connect directly to the daemon port using telnet, however the normal telnet does not allow any command line editing.

The most user friendly way is probably still to use the basic Web-interface of the daemon. However, only a subset of the available commands are implemented in the Web-client in order to keep it easy to use.

The shell can be run either on the same server as the daemon in which case it can simply be started with

$>tvpsh

or it can be run on a different computer in which case the tvpvrd server must be specified either on the command line as

$> tvpsh -s 192.168.010 -p 9301

or by storing the server and port setting in the tvpsh config file stored in the users home directory. The config file is named ".tvpshrc" and should be stored in the home directory.

When the daemon is run on the same server the shell will read the necessary informatoin from the daemons config file after looking first for the tvpsh config file in the users home directory.

Using the shell as a login shell

One possible wasy to use the shell is to use it as a system login shell. In this way it will be possible to login directly to the server by using, for example, ssh and connecting as a dedicated user who uses tvpsh as default login shell.

In order to do this there are two things that must be done:

  1. Add a new user to the server and specify tvpsh as the login shell. This is done by adding a line in the /etc/passwd file. For example as

    pvr:x:0:0:tvpvrd shell user:/home/pvr:/usr/bin/tvpsh 

    The above line creates a new user called pvr which uses tvpsh as login shell. (The 'x' in the password field indicates that the system is using shadow passwords.). You can also use the system tools you are comfortable with in order to create a new user.

  2. Allow tvpsh to be used as system shell by adding it to the list of allowed system shells in '/etc/shells'

Arguments

The following command line arguments are supported when starting the shell

-s, --server IP-address

Specify the server that is running tvpvrd. Default value is localhost.

-p, --port portnumber

TCP/IP port where the tvpvrd server is listening. If the shell is run on the same server as the daemon then the port will be automatically determined from the tvpvrd config file.

-h, --help

Print a short help and exit.

-v, --version

Print program version information and exit.

Files

.tvpshrc

Default configuration file in the users home directory.

Resources

  • SourceForge: <http://sourceforge.net/projects/tvpvrd/>

  • ivtv-driver: <http://ivtvdriver.org/>

  • Video for Linux: <http://linux.bytesex.org/v4l2/>

Author

Written and maintained by Johan Persson <johan162@gmail.com>

Copyright

Free use of this software is granted under the terms of the GNU General Public License (GPL v3)., see the file COPYING included in the distribution archive for details.

See also

tvpvrd(1), tvpowerd(1), ffmpeg(1), scantv(1), v4l-info(1), v4l-conf(1), v4lctl(1), xawtv(1)