Advanced Actions and Topics
Advanced Actions are special actions intended for power users, and may require additional components not included OOTB.
AdjustMetaData
Description: Adds WM/ToolName and WM/ToolVersion tags, edits WM/WMRVEndTime and WM/MediaOriginalRunTime (FixSlider), edits WM/SubTitleDescription (AddTooledDescription), and edits WM/WMRVScheduleItemID (IncrementScheduleItem).
Reads Context: CutDvrmsFile (optional), CutCommercialsDvrmsFile (optional)
Writes Context: None
Configure: AddTooledToDescription (true/false), FixSlider (true/false), IncrementScheduleItem (true/false), MetaMarker (text)
Cleanup
Description: deletes contents of the temp directory
Reads Context: None
Writes Context: None
Configure: None
ContextSeed
TBD
ConvertDVRMStoMPEG
Description: converts a DVRMS to an MPG
Reads Context: Graph (optional), InputFile, CutDvrmsFile, OutputFile, MultiplexorFilterGuid, FileOutputFilterGuid,
Writes Context: TempMpeg (optional)
Configure: FinalRender (true/false)
ConvertToWMV
Description: converts a specified context file DVRMS to WMV using DVR2WMV
Reads Context: *, OutputFile
Writes Context: None
Configure: CompatibilityMode (true/false), ContextFile (context value, file to convert), PrxName (text, path of prx file to use), TwoPass (true/false)
ConvertToWmvIC
TBD
CopyToPPC
TBD
CreateDVRPROJ
TBD
DeleteFile
Description: Deletes a specified context file
Reads Context: *
Writes Context: None
Configure: AreYouSure (true/false), ContextFile (context value, file to delete)
DoNothing
Description: Does nothing
Reads Context: None
Writes Context: None
Configure: None
DumpCommercialsXml
Description: Writes commercials found in FindCommercials to an Xml file (mainly for CommericalSkipAddIn)
Reads Context: Commercials
Writes Context: None
Configure: None
DVRMS2MPEGStreams
Description: converts a DVRMS to the base MPG/cc streams, or converts as a single file
Reads Context: InputFile, CutDvrmsFile, OutputFile
Writes Context: TempMpeg (optional)
Configure: FinalRender (true/false), MuxVideoForComskip (true/false)
DVRMS2WMA
Description: Converts DVR-MS file to WMA using specified WME profile (prx file)
Reads Context: OutputFile, *
Writes Context: None
Configure: ContextFile (context value, file to convert), PrxName(text, path to WME profile)
DvrmsCutOutCommercials
Description: Uses Toub’s DVRMS splicer to cut out commercials
Reads Context: InputFile, FrameRate, Commercials, OutputFile,
Writes Context: CutDvrmsFile or CutCommercialsDvrmsFile
Configure: AllowedIterations (text, number of iterations at the same progress before canceling), OutputCommercials (true/false), SaveOutput (true/false)
FileOperation
TBD
FindCommercials
Description: uses configured commerical analyzer (SA/Comskip) to find commercials in dvr-ms file
Reads Context: *, Debug (optional),
Writes Context: FrameRate, Commercials
Configure: Context File
FWThrottle
Description: This action is essential to how DTB controls the number of active worker processes, and should be added to every profile.
MigrateContextValue
Description: Copies a context value to another context value
Reads Context: *
Writes Context: *
Configure: ContextSource context value, name of context value to copy), ContextDestination (context value, name of context value to write to)
MoveOutputFile
Description: Move a specified context file to a specifed location, sets context file to new location
Reads Context: *
Writes Context: *
Configure: ContextFile (context value, file to move), DeleteExisting (true/false), DestinationPath (text, if UseRecordedTVPath is selected this is ignored, otherwise path to move to), UseRecordedTvPath (true/false)
MPEG2WMV
TBD
RenameFile
TBD
RenameFileWithRegex
Description: Replaces text with alternate text in the input file name
Reads Context: InputFile
Writes Context: InputFile
Configure:
ContextFile is the name of the Context on which to perform the Regex.
FindRegex
is the pattern to search for. The pattern contains replacement spans,
signaled by parentheses.
ReplaceRegex
is a string to replace the ENTIRE ContextFile value with. If you just
typed "DTb rules", then the new value of the ContextFile would
be EXACTLY "DTb rules". The power of Regex is that you can
combine "DTb rules" with replacement spans from the original ContextFile
value. Replacement spans are identified, in order, using "$1", "$2", etc.
RenameInputFile
Description: Replaces text with alternate text in the input file name
Reads Context: InputFile
Writes Context: InputFile
Configure: MatchExpression (text, text to find), ReplaceExpression (text, text to replace with)
RunExternal
Description: Runs an external command
Reads Context: TBD
Writes Context: TBD
Configure:
ProcessName: full path to program to run (do not use quotes)
ArgumentsContext: any arguments to the program. Context and MetaData can be passed to an external application using %ItemToGet% notation. For e.g. %InputFile% passes the current value of the InputFile Context parameter, and %Title% passes the value of Title from the dvr-ms file's metadata.