Processing Commands

About

Processing commands allows you to call on other applications to process your recordings. Processing can take place during or after recording.

There are several things Processing Commands can be used for, such as:

• Running Comskip to identify commercial breaks.
• Running Transcoding software to convert the recording to an additional format.
• Running tools to create files that contain information about the recording.

Use

Name

A name to easily identify the task.

Path

The location of the application or tool to be used to process the file.

Inbuilt within ArgusTV is the ability to execute pre/post Processing Commands that users can configure for their own uses. These processes can pass and generate variables to build sophisticated enhanced functionality. Syntax for variable require used of the double percentage quotes %%----%%, ie to pass the FILE path from ArgusTV to an external processing file it would be passed by using %%FILE%%

Arguments

The parameters to pass to the application or tool

CHANNEL The channel name SCHEDULE The schedule name CATEGORY The program category or '#' if none TITLE The title (no episode title and/or number) LONGTITLE The title including episode and/or number EPISODETITLE The episode title or '#' if none EPISODENUMBERDISPLAY The episode number as displayed or '#' if none EPISODENUMBER The episode number or '#' if none EPISODENUMBER2 The episode number in two digits or '00' if none EPISODENUMBER3 The episode number in three digits or '000' if none SERIES The series/season number or '#' if none SERIES2 The series/season number in two digits or '00' if none DATE The airing date in the format yyyy-MM-dd YEAR The airing year MONTH The airing month as a number DAY The airing day DAYOFWEEK The airing day of the week HOURS The airing time's hours in 24H format HOURS12 The airing time's hours in 12H format AM/PM MINUTES The airing time's minutes

In addition to these internal arguments sunsetdk see [1] has added additional functionality using the ArgusTV.Batch.ProcessCommand.exe file. Additional commands are as below

Command: MyVideo This command creates a XML file which is compatable with MediaPortal My videos so the description of the recording will show up in mediaportal.

Arguments:

The ArgusTV file to process, this must be passed in UNC format.

Example: ArgusYV.Batch.ProcessCommand.exe MyVideo\\htpc\recordings\Tom and Jerry 20010-02-24 1200.ts

This will create a file called Tom and Jerry 20010-02-24 1200.xml in the same folder as the recording with the info of the recording in MP XML format.

Command: Log This command writes all the parameters to the ArgusTV log. this can be used in the batch files to log that everything goes smooth in big batch files.

Arguments:

All arguments are writen to the ArgusTV log.

Example: ArgusTV.Batch.ProcessCommand.exe log "This is a test"

Will make one entry in the ArgusTV log with the text This is a test

Command: IsPartial This command can check if a recording is a partial recording. This will set ERRORLEVEL to 0 if the recording is full and to -1 if the recording is a partial.

Arguments:

The ArgusTV file to process, this must be passed in UNC format.

Example: ArgusTV.Batch.ProcessCommand.exe IsPartial "\\htpc\recordings\Tom and Jerry 20010-02-24 1200.ts" ERRORLEVEL will be set to 0 as this recording is full (recorded from scheduled start to scheduled end).

Command: Rename Renames the reference to a recording in the ArgusTV database. The actual file will not be renamed.

Arguments:

The ArgusTV file to process, this must be passed in UNC format. The new file name which the file reference should be changed to.

Example: ArgusTV.Batch.ProcessCommand.exe rename "\\htpc\recordings\Tom and Jerry 20010-02-24 1200.ts" "\\htpc\recordings\Tom and Jerry.mpg"

This will change the file reference in ArgusTV.

Command: Delete Deletes the reference to a recording in the ArgusTV database. It can also delete the file.

Arguments:

The ArgusTV file to process, this must be passed in UNC format. Delete the actual file: If you pass 1 then the referece and the file is delete, if you pass 0 the only the reference is removed.

Example: ArgusTV.Batch.ProcessCommand.exe delete "\\htpc\recordings\Tom and Jerry 20010-02-24 1200.ts" 0

This will delete the reference to the recording, but not the actual recording.

Command: Description

Creates a file with infomation from the ArgusTV database. The extension of the file must be passed as an argument so must what you want in the file.

Arguments:

The ArgusTV file to process, this must be passed in UNC format.

Extension: The extension of the new file. The name of the file is the same as the recording. The file will also be created in the same folder as the recording. What to write in the file: You write the whole string you want in the file here. Certain tags are replaced in the program. At the moment only 6 tags exist. {StartTime}{StopTime}{Description}{title}{EpisodeNumber}{SeriesNumber}

Example: ArgusTV.Batch.ProcessCommand.exe description "\\htpc\recordings\Tom and Jerry 20010-02-24 1200.ts" txt {starttime};{stoptime};{description}

This will create a file with the extension txt with the start time, stop time and the description of the show seperated with a semicolon(;)

When

When the application or tool will be run. Options are:

• Run when recording starts (Live).
• Run when recording ends.
• Run at a fixed time after the recording ends.
• Run before the recording is deleted.