Perl Modules

NAME

Videodump-PL - A simple script for recording from generic video stream devices in MythTV

DESCRIPTION

Until myth gets support for a certain device under v0.22, at least one of the authors of this script were dead in the water. This script will likely work with any hardware (/dev/video*) type device that dumps a video/audio stream.

SYNOPSIS

 videodump.pl
    -h help
    --help (-H) full help

    --buffer-time  (-b) buffer/recovery time
    --channel      (-c) channel
    --description  (-d) show description
    --background   (-f) fork/daemonize
    --group        (-g) group
    --lockfile     (-L) lockfile
    --logfile      (-l) logfile (no logging unless specified)
    --loglevel          0-3 - default: 2
    --myth-import  (-m) mythtv mysql import option (requires -p)
    --name         (-n) show name
    --output-path  (-o) output path
    --mysql-passwd (-p) mysql password (may require -o and/or -m)
    --remote       (-r) remote device
    --subtitle     (-s) subtitle description
    --show-length  (-t) length in minutes (default: 30 minutes)
    --video-device (-v) video device (default: /dev/video0)
    --file-ext     (-x) file extension (default: mp4), alters ffmpeg behavior
    --skip-irsend  (-I) skip irsend commands

OPTIONS

-b --buffer-time

buffer/recovery time in seconds needed between recordings to reset for next show default 1 second per 1 minute of recording time

-c --channel

channel, (default is nothing, just record whatever is on at the time)

-d --description

description detail (default imported by HD PVR)

-f --background

fork/daemonize (fork/detatch and run in background)

-g --group

group to chgroup files to after running ffmpeg (default: mythtv if it exists, '0' to disable)

-L --lockfile

lockfile location (default: /tmp/.vd-pl.lock)

-m --mysql-import

mysql import type 1 and 2 requires -p

When --mysql-import(-m) isn't specified, this script simply does a raw dump to output folder (--output-path/-o). Recording will be available for manual play as soon as recording starts, will NOT show up in mythtv mysql "recorded shows" list, best dumped to default MythVideo Gallery folder.

1

The output folder (output-path/-o) must be where mythtv recordings are stored by default. Shows will be imported into mysql imediately after they are done recording in raw format. Requires mysql password (--mysql-passwd/-p) switch!

2

Same as 1, but shows will be converted to mythtv native mpeg2 format with commercial flagging points. They will also show up in the recorded shows list after mpeg2 conversion (time will vary based on CPU). Requires mysql password (--mysql-passwd/-p) switch.

-n --name

name of file, also used as title (default: manual_record)

-o --output-path

output path where you want shows to be placed needs / at end (default /var/lib/mythtv/videos/)

-p --mysql-passwd

mysql password, default is blank. If you supply a password, will attempt to import into MythTV mysql! Found in Frontend -> Utilities/Setup->Setup->General You need supply -o, which needs to be the path to your MythTV recorded shows folder. You should use -m (1 or 2). If -m switch is not used, (-m 1) is assumed.

-r --remote

remote device to be controled by IR transmitter, change in MythTV Control Centre, look at /etc/lircd.conf for the chosen device blaster file that contains the name to use here (default dish)

-s --subtitle

subtitle description (default: recorded by HD PVR)

-t --show-length

The length of a show in minutes (default: 30 minutes)

-v --video-device

The device or video file you wish to record from or process (default: /dev/video0)

-x --file-ext

The file extension to be passed to ffmpeg. The extension alters the behavior of ffmpeg by changing the container format of the output!

The myth internal player plays the default (mp4) well. ts containers seem to play well also. mp4 converts to better mpeg2 output. External players play mp4 well, but possibly not ts.

-I --skip-irsend

Skip all irsend commands. These commands are intended to change channels and things, which may not be applicable or useful to all users.

-l --logfile

If specified, the program will putput whatever it's doing to the file specified. It will write the details in append mode. By default, no logging is performed.

--loglevel

By default, this application logs quite a bit of useful information, perhaps too much (default: 2). The following enumerates the loglevels:

0 - ERROR

log only errors

1 - ACTION

log ffmpeg commands

2 - INFO

log other interesting things (default)

3 - DEBUG

log every silly little thing

COPYRIGHT

Copyright 2009 -- David Stoll and Paul Miller

GPL

REPORTING BUGS

Please use the issue tracker at github:

http://github.com/jettero/videodump-pl/issues

REPOSITORY

http://github.com/jettero/videodump-pl

SEE ALSO

perl(1), ffmpeg(1)