Advanced concepts to use MCEBuddy

Tuning Comskip Commercial Detection

Comskip can be fine tuned to better detect and cut commercials for each country/region. There is a file names comskip.ini in the comskip directory in the MCEBuddy installation directory (by default C:\Program Files\MCEBuddy2x). The details of the tuning parameters can be found at: http://www.kaashoek.com/files/tuning.htm

If the video appears to get cut for about 3 seconds after the commerical ends (i.e. the commercial skipping cuts 3 seconds into the actual video post the end of the commerical), this could be because of the -ss settings in the <encoder>-video section of the profile. the -ss 3 command is required to get rid of corrupted video at the beginning to avoid audio sync issues. Remove the -ss 3 from the video parameters to fix this issue. Refer to the Audio Sync Issues section at the end of this document for details on the -ss command.

Multiple Audio Tracks in Converted File (v2.3.12+)

This only works with FFMPEG based profiles and if the source file has multiple audio tracks. Handbrake and MEncoder do not support converting/copying multiple audio tracks.

Select <Default> as the Audio Language in the conversion options AND add -map 0:a -map 0:v to the ffmpeg-video section for the FFMPEG profile and it will copy/convert all audio tracks.

Show Analyzer (v2.1.2+)

MCEBuddy supports ShowAnalyzer version 1.0 and greater. Once you download and install ShowAnalyzer it will show up as an option on the conversion profile settings page under commerical detection.

Filename and Showname Pattern Matching (v2.2.3+)

MCEBuddy supports multiple wildcard name matching to match shownames and filenames using the ; operator. E.g. once can specify *.wtv;*.avi*.mpg as the name selection criteria or ncis*;house*.mpg to match all names that start with ncis and house (ending with a .mpg).

If you want to specify a name avoid list, i.e. select all/abc files EXCEPT xyz, then prefix the name selection criteria with a ~ operator. E.g. ncis*;~ncis miami* will select all files that start with ncis but NOT those starting with ncis miami. E.g. *.*;~*.mp4;~*.avi will select all files except those starting with .mp4 and .avi

Name matching is case insensitive.

To select all default video types use the expression [video] which will match the following expression *.dvr-ms;*.wtv;*.asf;*.avi;*.divx;*.dv;*.flv;*.gxf;*.m1v;*.m2v;*.m2ts;*.m4v;*.mkv;*.mov;*.mp2;*.mp4;*.mpeg;*.mpeg1;*.mpeg2;*.mpeg4;*.mpg;*.mts;*.mxf;*.ogm;*.ts;*.vob;*.wmv;*.tp

For advanced users MCEBuddy also supports REGEX expressions. To provide a regex expression prefix the regex matching pattern with regex: and then the regex pattern (this is a very advanced concept).

Multiple Conversion Tasks Customized by ShowName or FileName (v2.2.3+)

Refer to Filename and Showname Pattern Matching above to understand how to create patterns for filename and shownames.

You can create multiple conversions tasks in MCEBuddy. Each conversion task will process each file in the queue. Order of conversions tasks do not matter when creating filename and showname filters. If you want to create custom conversion tasks for different files/shows you can do so with the help of the Filename or Showname pattern matching filters in the Conversion Tasks Settings page, under Advanced Settings.

For e.g. if you want to create 3 tasks, one that processes all NCIS files, one that processes all Star Trek files and one that processes all other files (i.e. default). To do so you will first create 3 conversion tasks.

In the first conversion task, where you want to process NCIS, under Filename or Showname filters (depending on what you want to filter based on, the name of the file or the name of the show taken from the metadata), you will enter NCIS* . This tell the conversion task to process only those files starting with NCIS.

In the second conversion task, where you want to process Star Trek files, under the Filename orShowname filter you will enter Star Trek* .

In the third conversion task, you want to process ALL other files (ie default), then you will enter the following *;~NCIS*;~Star Trek* . The first * tells the conversion task to process ALL files, the~NCIS* tells the task NOT to process files starting with NCIS and ~Star Trek* tells the task NOT to process files starting with Star Trek, i.e. process all files except those which are being processed by the first two tasks.

Custom File Renaming Pattern (v2.1.6+)

MCEBuddy allows you to create your own custom file name and directory structure using the metadata stored in the file and downloaded from the internet.

The following commands are currently supported by MCEBuddy

  • %originalfilename% - Name of the source file (without the path or extension)
  • %showname% - Showname / Title
  • %episodename% - Episode Name / Subtitle
  • %season%## - Season No
  • %episode%## - Episode No
  • %network% - Network channel on the show was recorded (v2.1.10+)
  • %airyear% - Original Air Year
  • %airmonth% - Original Air Month
  • %airmonthshort% - Original Air Month Name Abbreviation (v2.3.11+)
  • %airmonthlong% - Original Air Month Full Name (v2.3.11+)
  • %airday% - Original Air Day
  • %airdayshort% - Original Air Day of Week Abbreviation (v2.3.11+)
  • %airdaylong% - Original Air Day of Week Full Name (v2.3.11+)
  • %airhour% - Hour of air date (v2.3.6+)
  • %airhourampm% - Air date hour in AM/PM (v2.3.12+)
  • %airminute% - Minute of air date (v2.3.6+)
  • %recordyear% - Record Year
  • %recordmonth% - Record Month
  • %recordmonthshort% - Record Month Name Abbreviation (v2.3.11+)
  • %recordmonthlong% - Record Month Full Name (v2.3.11+)
  • %recordday% - Record Day
  • %recorddayshort% - Record Day of Week Abbreviation (v2.3.11+)
  • %recorddaylong% - Record Day of Week Full Name (v2.3.11+)
  • %recordhour% - Record Hour (v2.1.10+)
  • %recordhourampm% - Record Hour in AM/PM (v2.1.12+)
  • %recordminute% - Record Minute (v2.1.10+)
  • %ismovie%<RenamePatternIfTrue,RenamePatternIfFalse> - If recording is a movie rename using True pattern, else rename using False pattern (v2.3.12+)
  • \ - Directory Separator

E.g.: TVShows\%showname%\Season %season%\%showname% - S%season%##E%episode%## - %episodename% - %airyear%_%airmonth%_%airday%

Will produce: TVShows\CSI\Season 1\CSI - S01E02 - Best of times - 2012_01_06.<ext>

E.g.: Recording\%ismovie%<Movie\%showname%,TVShows\%showname%\Season %season%\%showname% - S%season%##E%episode%##>-Converted

Will produce:

Recording\Movies\Star Wars-Converted.<ext> (for a movie) OR

Recording\TVShows\CSI\Season 1\CSI - S01E02-Converted.<ext> (for non movies)

The extension is added automatically depending upon the profile specifications.

The number of #'s at the end for Episode and Season indicates the number of digits in the written number. E.g. %season%## will give the output at 01 while %season%### will give the output at 001. #'s are optional, leaving them out will write the number without any formatting. i.e. %season% will give 1 as the output.

Audio Sync/Missing Issues

Sometimes the audio and video go out of sync due to corruption at the start of the video. To solve this problem add the parameter -ss 10 at the BEGINNING of the <encoder>-video parameter in the profile. DO NOT put this parameter in the general parameters section. (do not forget the - before the ss and make sure there is a space between ss and 10)

E.g. ffmpeg-video=-ss 10

This indicates that ffmpeg will skip the first 10 seconds of the video/audio after decoding it (if you put this in the general parameters section then the encoder will skip over first 10 which DOES NOT solve the problem, the video/audio need to be first decoded and then discarded to be put back in sync).

You can play with the number to find the right mix, it can be as low as 3 or as high as 30 depending upon the corruption. You'll be surprised how many videos are corrupted at the start and FFMPEG is very sensitive to corruption as far as audio sync goes. You often cannot see the corruption while play the video (it will look okay), these are at the frame level and often ignored by players.

Also try to play with the AudioDelay parameter (given above). Set to skip to see if that resolves the issue. If the Audio sync is still off, try setting the AudioDelay number to +ve or -ve to advance or retard the audio sync and see how it behaves. It is a trial and error process.

If you're using FFMPEG or Handbrake as the encoder with your profile AND your output extension is .MP4 or .M4V AND your audio is going out of sync ONLY when you remove commercials (i.e. the Audio is in sync without commercials removal), try to use an alternative commerical stripping by using the command CutMP4Alternative=true in your profile.

If that doesn't work try using UniversalCommercialRemover=true in your profile. See above for more details.

Sometimes the Audio gets cut out completely in between a video. Try using PreConversionCommercialRemover=true in your profile. See above for more details.

Using Custom XML Files (v2.3.12+)

MCEBuddy looks for a XML file along with the original source video (with the same source video filename). It uses this file to extract Metadata information for non WTV/DVRMS files.

Also, it MCEBuddy find a XML file created during the conversion process (e.g. from Comskip), it will copy the XML file to to the destination directory along with the converted file.

Using Custom EDL Files (v2.3.12+)

MCEBuddy looks for a EDL file along with the original source video (with the same source video filename). If it finds the EDL file with the source video it copies the EDL file to the output directory along with the converted file.

MCEBuddy gives preference to the Custom EDL file over Comskip/ShowAnalyzer generated EDL files.

Using Custom SRT Files (v2.1.8+)

MCEBuddy looks for a SRT file along with the original source video OR in the temp working directory (with the same source video filename). If it finds the SRT file in either place it copies the SRT file to the output directory along with the converted video (with preference given to a SRT file in the temp working directory).

If ExtractCC is enabled in the Conversion Task -> Advanced Settings it will trim the Custom SRT file to be in sync with the EDL file (commercial removal). MCEBuddy gives preference to the Custom SRT files over the CC generated SRT file.

Comskip can be set to generate SRT files (output_srt=1) or CCExtractor can be used using from Custom Commands (if the ExtractCC from the GUI fails to work) to generate SRT files during the conversion process. Once generated, MCEBuddy will copy them to the output directory along with the converted file.

MultiThreading Support (v2.1.2+)

MCEBuddy by default calculates how many threads are required for the programs to run optimally. However this can be overridden manually by specifying the threads in the general parameters in the profiles file for each profile and encoder type.

Advanced parameters to configure MCEBuddy

(apply to mcebuddy.conf)

HOW TO MAKE CHANGES TO MCEBUDDY.CONF

Start the MCEBuddy application from the Start Menu. Click on Stop to stop the MCEBuddy engine. This is VERY important, if you don't press Stop, the changes you make to mcebuddy.conf will be overwritten. Open mcebuddy.conf in Notepad, make the required changes and save the file. Now click Start on the MCEBuddy application.

 

DownloadBanner=<false> (v2.1.12+)

By default, this value is true. If this is set to false, then MCEBuddy will not download the Banner file (artwork) for the movie or tv series. This can be used when you want to download the series information (check Download Series Details from the Conversion Task page) but not download the artwork / banner file.

CPUAffinity=<binary mask integer> (v2.1.12+)

This parameter can be set to set the CPU affinity mask. This limits MCEBuddy to 1 or more processors only as specified in the bitmask. While this number is written as an integer, the integer represent a binary mask with each bit representing a processor. HINT: Convert the integer to a binary representation, each bit in the binary number presents a CPU processor.

E.g.:

CPUAffinity=1 will select the 1st CPU processor

CPUAffinity=2 will select the 2nd CPU processor

CPUAffinity=3 will select the 1st and 2nd CPU processor

CPUAffinity=4 will select the 3rd CPU processor

CPUAffinity=5 will select the 1st and 3rd CPU processor

CPUAffinity=6 will select the 2nd and 3rd CPU processor

CPUAffinity=7 will select the 1st, 2nd and 3rd CPU processor

TempWorkingPath=xyz (v2.1.2+)

This parameter is used to manually specific the temp working directory for MCEBuddy, i.e. xyz. By default MCEBuddy uses a directory called working within the MCEBuddy installation directory (e.g. C:\Program Files\MCEBuddy2x\working) (it will make multiple directories if using multiple simultaneous conversions with a number at the end for each parallel conversion, e.g. working0, working1 etc). This has to be a complete working path with rights to be able to create, modify and delete files/directories else the conversion might fail. This parameter should come under the section [Engine] in the conf file.

E.g. D:\Temp\MCEBuddy

PollPeriod=xxx (v2.1.2+)

This parameter specifies how often MCEBuddy should check the Monitor Locations for new files. xxx is defined in number of seconds. This parameter should come under the section [Engine] in the conf file.

E.g. PollPeriod=150

NOTE: By default MCEBuddy uses 300 seconds as the interval to check for new files.

LocalServerPort=xxx (v2.2.16+)

This parameter specifies the TCP/IP port of the installed MCEBuddy server engine on the local machine. MCEBuddy registers this port with the any UPnP enabled routers on the network by default to enable remote connections from outside the network (NAT). This is the MCEBuddy GUI application should connect to for the local machine. The default port used by MCEBuddy is 23332. This parameter should come under the section [Engine] in the conf file.

E.g. ServerPort=23332

HangPeriod=xxx (v2.2.4+)

This parameter specifies how long MCEBuddy will wait for a console output from the application (e.g. handbrake or ffmpeg etc) before it determines that the application has hung and terminates it. xxx is defined in number of seconds. This parameter should come under the section [Engine] in the conf file. Use 0 to disable hang detection (i.e. MCEBuddy will wait forever for the process to exist normally).

E.g. HangPeriod=500

NOTE: By default MCEBuddy uses 300 seconds as the interval to determine a hung application

FFMpegBackupRemux (v2.1.12+)

This is a special section in the configuration file that stores the command parameters for the ReMux operations which are carried out using FFMPEG if the main ReMuxSupp application fails/not used to remux the video. First the CopyRemux is used, if that fails then the SlowRemux is used. CopyRemux is used first for MPEG2 video files to stream copy the video without recoding the video. If the original video is not MPEG2 or CopyRemux fails then SlowRemux parameters are used to remux the video. THESE SHOULD NOT BE CHANGED UNLESS THE BACKUP REMUX IS COMPLETELY FAILING. Each of these entries will have a number after them like CopyRemux0, CopyRemux1, SlowRemux0, SlowRemux1 etc. These numbers indicate successive remux parameters to be tried if the previous one fails, i.e. if SlowRemux0 fails then MCEBuddy will look for SlowRemux1 and if that fails then it looks for SlowRemux2 etc.

You can also specify -i <source> in the remux parameters as a placeholder for the input filename which MCEBuddy will replace at runtime. This can be useful if you want to specify parameters before the input file in the FFMPEG parameter command.

E.g. CopyRemux0 = -fflags +genpts -i <source> -map 0:a -map 0:v -vcodec copy -acodec copy

MCEBuddy automatically detects the frame rate of the video through the use of -r auto in the FFMPEG Remux parameters in CopyRemux and SlowRemux. This can be disabled by removing -r auto. It can also be overridden by manually specifying the frame rate to use (which can be useful if the average rate of dropped and/or duplicate frames is very high leading to stuttering videos).

E.g. -r auto
E.g. -r 25
E.g. -r 30*1000/1001

MCEBuddy monitors the Average Rate of Dropped frames and Average Rate of Duplicate frames, the key is average rate and not absolute value. If this exceeds a threshold then the auto detected frame rate is incorrect and needs to be corrected. These thresholds can be specified in the parameters RemuxDropThreshold and RemuxDuplicateThreshold. If that threshold is exceeded you may need to manually specify the frame rate (see above).

E.g. RemuxDropThreshold=3.0
E.g. RemuxDuplicateThreshold=3.0

[FFMpegBackupRemux]
CopyRemux0=<FFMPEG Remux parameters>
SlowRemux0=<FFMPEG Remux parameters>
SlowRemux1=<FFMPEG Remux parameters>
RemuxDropThreshold=<Average Rate of Dropped Frames threshold>
RemuxDuplicateThreshold=<Average Rate of Duplicate Frames threshold>

Advanced parameters to tweak the conversion

(apply to each profile in profiles.conf)

AllowH264CopyRemuxing=true (v2.3.12+)

This parameter tells MCEBuddy to internally allow remuxing H264 video into a TS format without converting it to MPEG2 video first. This can be used when one wants to change the format of the video while retaining the original H264 video without recoding it. E.g. from WTV to MP4 or WTV to MKV or WTV to TS, or even WTV to WTV and remove commercials etc.

For more details on this refer to this thread http://mcebuddy2x.codeplex.com/discussions/431449 

NOTE: The limitation on this is that Comskip cannot be used for commercial removal since comskip does not support H264 in TS processing, however ShowAnalyzer can be used in it's place.

UseWTVRemuxsupp=true (v2.3.11+)

This parameter tells MCEBuddy to use Remuxsupp FIRST to remux WTV files before trying other remuxers. This can help with some videos (rare) that not remuxed properly with FFMPEG or other remuxers but work with Remuxsupp. Usually Remuxsupp does not work well with many videos. 
NOTE: This only helps in certain situations where files remuxed by FFMPEG are not able to be converted by MEncoder.

ForceEDL=true (v2.1.4+)

This is only effective when Comskip is enabled and Custom EDL files are not provided. When the commercial removal option is set to Comskip it tells MCEBuddy to force use the EDL file instead of the EDLP file from Comskip. EDL/EDLP files indicate the sections (timestamps) of the video to cut (commercials), however the timestamps differ slight for each video format, some use EDL and others EDLP. If your video/show is getting cut before/after commercials by a few seconds then try using this parameter.
NOTE: By default MCEBuddy uses EDL for .TS files and EDLP for all others

ForceEDLP=true (v2.1.4+)

This is only effective when Comskip is enabled and Custom EDL files are not provided. When the commercial removal option is set to Comskip it tells MCEBuddy to use the EDLP file instead of the EDL file from Comskip. EDL/EDLP files indicate the sections (timestamps) of the video to cut (commercials), however the timestamps differ slight for each video format, some use EDL and others EDLP. If your video/show is getting cut before/after commercials by a few seconds then try using this parameter.
NOTE: By default MCEBuddy uses EDL for .TS files and EDLP for all others

FixedResolution=true (v2.1.4+)

This tells MCEBUddy not to change source video resolution while converting (keep source resolution). When this paramter is set, MCEBuddy ignores the resolution slider on the conversion profile page.

SkipCropping=true (v2.1.4+)

This tells MCEBuddy not to autodetect crop information and skip cropping the video. This helps when the video edges are being cut off or if you have a video with no black bars on the sides to be removed, it will speed up the conversion process. Auto cropping can also sometimes skew the aspect ratio, so setting this will make MCEBuddy skip cropping.

<encoder>-AudioDelay=xxx/auto/skip (v2.1.2-2.2.18, 2.2.19+)

This parameter is set for each encoder type, e.g. ffmpeg, mencoder or handbrake
When xxx is set to skip then it tells MCEBuddy to skip auto correction of audio delay (sync). This is useful for some file formats such as AVI where audio gets skewed on auto correction.
If this parameter is set to a numerical value, then this parameter is used to manually specify the audio delay correction to correct audio sync, xxx is a +ve or a -ve number in seconds. If the value is equal to auto, it adds or subtracts the delay specified to the auto calculated audio delay for the video. A value of 0 means that MCEBuddy will skip any delay correction.
By default this this parameter is set to skip.

E.g. mencoder-AudioDelay=0.85

2ChannelAudio=true (v2.1.5 - v2.1.9, v2.2.13+)

When this parameter is set MCEBuddy limits the output audio to 2 channels irrespective of number of inputs channels
This can be useful to when specialized devices/software can read only 2 channels
By default MCEBuddy sets the output channels to the number of input channels
(As of 2.1.10, this can also be set in the Conversion Task GUI - profile overrides GUI)

MEncoderEDLSkip=true (v2.1.4+)

This parameter tells MCEBuddy not to use the EDL command with MEncoder to remove commercials from the video during conversion (which can save time but sometime cause the audio to go out of sync in rare cases).
If this parameter is set then MCEBuddy will remove the commercials AFTER the conversion is completed by using MP4Box to cut the commercials. Please do not set CutMP4Alternative=true when using this parameter.
This can be used to if converting with Mencoder is causing your Audio to go out of sync while removing commercials (it has no impact if commercial stripping is disabled) and none of the other parameters (-ss 30 or mencoder-audiodelay=skip ) do not work.

UniversalCommercialRemover=true (v2.3.11+)

When is parameter is set it tells MCEBuddy to use the Universal Commercial Remover after the conversion is complete (where as the default are very specific commercials remover functions for each file type, but they can sometimes fail as they are very sensitive to errors and sync issues). This helps when the standard profile is failing or causing audio issues during the commercial removal stage. While this cutter can leave some artifacts where the video is cut, however it works on ALL file types and will work successfully without any audio sync issues.

The other advantage of UniversalCommercialRemover=true is that it support files with multiple audio tracks and preserves them where as other mechanisms may or may not support depending up the file type.

(v2.3.12+) Setting UniversalCommercialRemover=true will force all commercials to be cut post conversion, unless PreConversionCommercialRemover=true is set. This can be used an option if commercial removal are failing or if a new file format is being used which is not natively supported by MCEBuddy.

PreConversionCommercialRemover=true (v2.3.12+)

When is parameter is set it tells MCEBuddy to use the Universal Commercial Remover to remove the commercials before the conversion (rather than the usual case of removing commercials after conversion). This helps when the conversion is failing during the commercial removal stage. While this cutter can leave some artifacts where the video is cut, however it works on ALL file types and will work successfully without any audio sync issues. This option is independent of UniversalCommercialRemover. If the preconversion commercial removal fails, it will automatically fall back to the post conversion commercial remover.

CutMP4Alternate=true (v2.1.4+)

When is parameter is set it tells MCEBuddy to use an alternative mechanism for remove commercials from MP4 and M4V files after the conversion is complete. By default MCEBuddy uses MP4Box to remove commercials during the last step, if this parameter is set it will use MEncoder to remove commercials. This helps sometime when the Audio Goes out of sync with the video after using Comskip/ShowAnalyzer but is in sync without Comskip. NOTE: This parameter is only effective when using using FFMPEG or Handbrake encoders. When using mEncdoder as the encoder, this parameter has NO effect as the commercial will always be stripped during the conversion itself (unlike FFMPEG and Handbrake, who's commercials are stripped out AFTER the conversion is complete).

CommercialSkipCut=true (v2.1.4+)

If this parameter is set, it tells MCEBuddy to do the Commercial Scan but NOT to cut the commercials. Instead it will copy the generated EDL file to the output directory along with the converted file.
Comskip generates 2 types of files, EDL and EDLP. Use the ForceEDL and ForceEDLP command to specify which file to use. See above for more details.
NOTE: When this parameter is set, the Closed Caption/SRT files generated will NOT be trimmed to match the EDL file.

Running Custom Commands (v2.1.8+)

MCEBuddy can provide the user with an option to run a single command at the end of the conversion process just before the file is renamed and moved to the destination directory.
To do so the following parameters need to be defined for the profile for which a custom command needs to be run.

CustomCommandPath=<Full Path of the executable>

CustomCommandParameters=<Optional parameters to be passed - see below for list>

CustomCommandHangPeriod=<0 or +ve number>

CustomCommandCritical=<true or false>

In the CustomCommandParameters you can use the parameter:

  • %convertedfile% - will be replaced with the full name and path of converted file as part of the parameters passed to the custom program.
  • %sourcefile% - will be replaced with the name and path of the original source video.
  • %remuxfile% - will be replaced with the name and path of the intermediary .TS file generated in the temp working directory if the source video is a WTV or DVR-MS file. Please note this will be blank if the source video is not a WTV or DVR-MS file. The following data is extracted from the Source Video metadata when available
  • %srtfile% - Full path to SRT file, if it exists, otherwise blank (v.2.3.12+)
  • %edlfile% - Full path to EDL file, if it exists, otherwise blank (v.2.3.12+)
  • %workingpath% - Full path to the temp folder where the converted file is kept (v.2.3.12+)
  • %originalfilepath% - Full path of the source file
  • %originalfilename% - Name of the source file (without the path or extension)
  • %showname% - Title of the show
  • %episodename% - Subtitle of the show
  • %episodedescription% - Description of the show
  • %season%## - Season no
  • %episode%## - Episode no
  • %bannerfile% - Full path to downloaded banner file
  • %bannerurl% - URL to banner file
  • %movieid% - MovieDB.com Movie Id
  • %seriesid% - TVDB.com Series Id
  • %genre% - Genre
  • %ismovie% - True or False if the video is a movie
  • %airyear% - Year of air date
  • %airmonth% - Month of air date
  • %airmonthshort% - Month of air date abbreviation (v2.3.11+)
  • %airmonthlong% - Month of air date full name (v2.3.11+)
  • %airday% - Day of air date (v2.3.6+)
  • %airdayshort% - Day of air date abbreviation (v2.3.11+)
  • %airdaylong% - Day of air date full name (v2.3.11+)
  • %airhour% - Hour of air date (v2.3.6+)
  • %airhourampm% - Hour of air date in AM/PM (v2.3.12+)
  • %airminute% - Minute of air date (v2.3.6+)
  • %recordyear% - Year of record date
  • %recordmonth% - Month of record date
  • %recordmonthshort% - Month of record date abbreviation (v2.3.11+)
  • %recordmonthlong% - Month of record date full name (v2.3.11+)
  • %recordday% - Day of record date (v2.3.11+)
  • %recorddayshort% - Day of week from record date abbreviation (v2.3.11+)
  • %recorddaylong% - Day of week from record date full name (v2.3.11+)
  • %recordhour% - Hour of record date (v2.3.12+)
  • %recordhourampm% - Hour of record date in AM/PM (v.2.3.12+)
  • %recordminute% - Minute of record date
  • %network% - Network channel on the show was recorded

CustomCommandParameters is CASE SENSITIVE.

e.g. CustomCommandPath = C:\Test 1\test.exe

e.g. CustomCommandParameters = /i %convertedfile% /o %sourcefile% -t

In the above exampled, %convertedfile% will be replaced by the full path and filename of the converted file in DOUBLE QUOTES. The %sourcefile% will be replaced with the full path and name of the original source video.

The number of #'s at the end for Episode and Season indicates the number of digits in the written number. E.g. %season%## will give the output at 01 while %season%### will give the output at 001. #'s are optional, leaving them out will write the number without any formatting. i.e. %season% will give 1 as the output.

NOTE: While running a custom command, the output is redirected to the log file with a debug log status.

CustomCommandHangPeriod represents the number of SECONDS MCEBuddy will wait during which if no output is detected and logged to the log file and it determines the process to be hung and kills it. Set it to 0 to DISABLE hang detection. Please note that if hang detection is disabled, MCEBuddy will wait endlessly for the process to finish before proceeding (or the task is deleted/stopped).

CustomCommandCritical, when this is set to true, MCEBuddy will fail the entire conversion if the custom command is invalid or if the process is terminated (due to hang detection). If it is set to false then MCEBuddy will continue with the conversion processing irrespective of the custom command failure/success UNLESS the converted file has been renamed or deleted. By default the value is false.

NOTE: MCEBuddy will fail the conversion process if the custom command deletes or renames the converted file (%convertedfile%). Also note, Custom Command will fail if it cannot find the file specified (avoid using executables files on network drives since MCEBuddy uses the Windows Service account to access network drives and sometimes these are not mapped correctly due to credential issues)

Last edited Feb 12, 2013 at 7:25 PM by rboy1, version 30