User Jobs

From MythTV Official Wiki
Revision as of 12:17, 27 July 2007 by WhyTey (Talk | contribs)

Jump to: navigation, search

User Jobs are programs which can act on MythTV recordings. A MythTV system currently supports four User Jobs.

Adding a User Job

There are two ways to add a User Job into the system:

1) In the mythtv-setup program

2) By using some SQL statements to insert the job directly. For example, a hypothetical job which edits bad language:

% mysql mythconverg
UPDATE settings SET data='/path/to/rm-swearing.sh %DIR%/%FILE%' WHERE value='UserJob1';
UPDATE settings SET data='Swearing Removal' WHERE value='UserJobDesc1';
UPDATE settings SET data='1' WHERE value='JobAllowUserJob1';

User Job arguments

A user job is just a program or script which is passed some arguments to tell it what recording to perform work on. Either the channel and start time, or the directory and filename, should be sufficient to uniquely identify the recording.

Options for User Jobs on the Backend
Option Description
%CHANID% Channel ID
%STARTTIME% Start Time of the Recording
%DIR% Path to the recording directory
%FILE% The file name
%TITLE%
%SUBTITLE%
%DESCRIPTION%
%HOSTNAME%
%CATEGORY%
%RECGROUP%
%PLAYGROUP%
%CHANID%
%STARTTIME% In the format yyyyMMddhhmmss
%ENDTIME%
%STARTTIMEISO% In the ISO date format YYYY-MM-DD hh:mm:ss
%ENDTIMEISO%
%PROGSTART%
%PROGEND%
%PROGSTARTISO%
%PROGENDISO%
%VERBOSELEVEL%

User Job Examples

Command Description
/usr/bin/mythcommflag -s %STARTTIME% -c %CHANID% --gencutlist Imports the flagged commercials into the cutlist
/usr/bin/mythcommflag --queue --gencutlist -f %FILE% Imports the flagged commercials into the cutlist
CopyAndTranscode Copies a recording before transcoding it
ipod_export Exports recordings in a video iPod compatible format
nuvexport --ffmpeg --infile="%FILE%" --path=/myth/exports/PocketPC --height=240 --width=320 --mode=xvid --deinterlace --nonoise_reduction --nice=19 Exports a program to Pocket PC sized Xvid using nuvexport.