Register:
Do you like ffmpegX and want to support its development? Please register.
Download and install:
Click to download and install the latest version of ffmpegX for MacOSX 10.2, 10.3 et 10.4.

Mailing list:
If you want to receive an email when ffmpegX is updated, sign up to the mailing list by entering your email address here:

Support and feedback:
For support, check the FAQ page and the ffmpegX forum. You may also like to sign up the mailing list. Have a suggestion on how to make ffmpegX even more useful? Send your feedback and comments to major.

 

Home - News - Download - How-To's - Benchmarks - FAQ - Forum

ffmpegX Documentation


  • The filters tab includes all settings related to pre-processing of the video stream before encoding, eg applying a filter, adding a subtitle, or cropping the image area.

  • Enabling the "VOB Subtitles" checkbox activates the specified VOB/VIDEO_TS subtitle (encoded as bitmap images into the DVD). When encoding from a non-encrypted VIDEO_TS folder, the available subtitles and numbers will be automatically listed in the popup menu. When encoding from a VOB file you may need to use the exact subtitle number of the source (adjust if the source numbering begins from 1 or from 0). You can use "Preview" to preview the currently selected VOB subtitles. The subtitles will be either "burned" in the video output, or extracted as a separate VobSub .idx/.sub file, depending from the value of the following popup menu:
  • Choose this option to "burn" the specified VOB subtitle in the encoded image. Useful when encoding to SVCD or CVD. This option requires the mpeg2enc engine and the option "Decode with mplayer" enabled.
  • Choose this option to extract the subtitle while encoding, as a separate VobSub file. The VobSub format is made of an .idx file containing the timecodes and a .sub file containing the VOB subtitles in image format. This format has nothing to do with the .sub text format. You can play back movies with VobSub subtitles with the ffmpegX "Play" command. (NB: extraction to ".srt" format is also possible but not while encoding, you should use for that the "Extract" command below).
  • Extracts subtitles without re-encoding. Open source file in the Open.. field and define the subtitle destination base name in the Save as... field. Then select the output format in the pulldown menu. Available formats are: extracts the subtitles from a VOB file or a non-encrypted VIDEO_TS folder as a VobSub file. extracts the subtitles from a VOB file in text format. Uses the gocr OCR engine to read the subtitles in image format from the VOB file and convert them into text formatted in .SRT SubRip format. You can play back movies with SubRip subtitles by using Mplayer OSX, or the ffmpegX "play" command (which invokes the external mplayer component), or with many other Mac, Linux and PC players. TitleLab can open SubRip titles and convert them to Quicktime-based subtitles. You can also convert a SubRip subtitle into a DVD Studio Pro 1.5 subtitle by using the corresponding tool in the Tools tab. The OCR process is interactive and takes place in Terminal window. If a character is not recognized, you will be asked to type it, eg.:


  • in this example the characters "yt" were merged together and the OCR was unable to recognize them. So the program asks you to type them (if it is only one character just type it, if it's two or more, enter them between quotes " "). The OCR program then asks if you want to remember the pattern so as to replace it automatically without asking in case it appears again (0=no, 1=just store in memory for this subtitle conversion, 2=store into a file to remember for all future conversions).
  • This option allows to select a subtitle in text format, like a SubRip or a MicroDVD subtitle (.srt, .sub, .jss..) and to include it in the encoded movie. If you encode to DVD format (without "Decode with mplayer" option), then subtitles will be encoded as image-based DVD selectable subtitles. If you encode to SVCD/CVD/DVD with the "Decode with mplayer" option and the "Burn" option enabled, then subtitles will be "burned" in the image. If you encode to mencoder DivX/XviD/H264, then subtitles will be also "burned" in the image. You may use the "Preview" and "Play" buttons to preview the source movie with subtitles.
  • Unless you're including a subtitle from a VIDEO_TS folder, you may sometimes experiment color palette problems both in playback and encoding (eg the subtitle is black, or has incorrect antialiasing). In that case, use this control to locate a VTS_01_0.IFO file containing DVD color palette information (you should copy it when extracting and keep it with the subtitle).
  • Choose the subtitle font to be used when burning text-based subtitles in DivX/XviD/h.264/mpeg1/2 or when creating DVD selectable subtitles. Available fonts are a subset of the Apple fonts installed in OSX 10.3. Fonts for non-latin alphabets are available, like Chinese, Japanese, Cyrillic, Greek, etc. (Click the 'Play' button with a subtitle file loaded in the Filters tab to preview its font).
  • Choose the subtitle text encoding to be used when burning text-based subtitles in DivX/XviD/h.264/mpeg1/2 or when creating DVD selectable subtitles. Allow to use subtitle files with non-english characters sets. More than 60 choices are available to cover almost all possible cases. (Click the 'Play' button with a subtitle file loaded in the Filters tab to preview it with the selected text encoding).
  • Select the subtitle font size to be used when burning text-based subtitles in DivX/XviD/h.264/mpeg1/2 or when creating DVD selectable subtitles. (Click the 'Play' button with a subtitle file loaded in the Filters tab to preview with the selected font size).
  • Sets the subtitle position for text-based subtitles. When encoding to mpeg-2 with the "Decode with mplayer" and "Burn" options enabled, you can burn in the image a text-based subtitle, and use this control to set its position (0=top, 100=bottom). Use the "Preview" button to check the position and move subtitles interactively with keyboard controls R/T, and find the right value to use. Note that image-based subtitles have a preset position and can't be moved with this control.
  • Crops the image before encoding. Useful to cut off black bars in libavcodec mpeg-4 and XviD encoding. The values are TBLR (top, bottom, left, right) for both mencoder and ffmpeg cropping. Cropping is currently not available for mpeg2enc engine.
  • Click this button to immediately and automatically fill the crop values in TBLR format. The crop analysis is made at the "Start from:" position in the Preview box (by default set at 0:30 to avoid initial black images). After cropping the movie will be automatically previewed from the "Start from:" position with the crop area highlighted as a white hairline. You may then adjust manually if needed an click "Preview" to preview again the crop area. Autocrop is available with mencoder and ffmpeg engines.
  • Previews the source movie starting from the min:sec position (default is 00:30 to avoid possible black images at the beginning). Simulates the crop area with a white-border border in the picture, renders the subtitles, adds filters (excepted mpeg-2 filters), activates the movie duration on-screen-display, and plays the selected audio track. Use it to test settings before encoding.
  • Splits an avi or mpg file in two, at position defined in the "Start from:" fields. Click "Preview" to check if the split position is good, then hit the "Split" button.
  • Select options in this box to preprocess the image with a filter before encoding. Filters (excepting mpeg-2 filters) can be previewed with "Preview".
  • The deinterlace filter is available for mencoder mpeg-4, xvid, ffmpeg and mpeg2enc codecs. Slows down the encoding. It can be previewed with "Preview" for mencoder mpeg-4 and xvid. Use this filter to deinterlace TV- or cam-type sources.
  • The denoise filter is available for mencoder mpeg-4, xvid, and mpeg2enc codecs. Slows down the encoding. Use it only if your source has noise and is not high-quality. It can be previewed before encoding with "Preview" for mencoder mpeg-4 and xvid.
  • The dering filter is available for mencoder mpeg-4 and xvid codecs. It reduces ring-type artifacts present in the source movie. Slows down the encoding. Use it only if your source has visible ring artifacts. It can be previewed before encoding with "Preview".
  • The deblock filter is available for mencoder mpeg-4 and xvid codecs. It reduces block-type artifacts present in the source movie. Slows down the encoding. Use it only if your source has visible block artifacts. It can be previewed before encoding with "Preview".
  • The brightness filter is available for mencoder mpeg-4 and xvid codecs. It can be previewed before encoding with "Preview". Range is from -100 to 100.
  • The contrast filter is available for mencoder mpeg-4 and xvid codecs. It can be previewed before encoding with "Preview". Range is from -100 to 100.
  • The luminance (luminance contrast) filter is available for mpeg2enc codecs. It needs the "Denoise" filter enabled to work. It can only previewed while encoding with the preview button located next to the Save as.. field. Range is from 0% to 255%.
  • The saturation (chrominance contrast) filter is available for mpeg2enc codecs. It needs the "Denoise" filter enabled to work. It can only previewed while encoding with the preview button located next to the Save as.. field. Range is from 0% to 255%.
  • The sharpness filter is available for mpeg2enc codecs. It needs the "Denoise" filter enabled to work. It can only previewed while encoding with the preview button located next to the Save as.. field. Range is from 0% to 255%. Do not set too high as it will increase bit-noise.
  • This feature is only enabled for ffmpeg engine. It adds black padding areas at Top/Bottom/Left/Right of the encoded image (values in pixels). To correctly use this feature, you should first reduce the image size depending on the source aspect ratio, then add black areas to match to playback aspect ratio. (Pleate note: When "Decode with Quicktime" is used, auto-letterboxing is always enabled and will overrid the manual settings).

© Copyright 2003-2006 Major