08 Jan 2017

Help Options

  1. Preferred video resolution
  2. Preferred audio bitrate
  3. Prefer high frame rate videos
  4. Prefer high dynamic range videos
  5. Download subtitles
  6. Manual quality selection
  7. Formats to ignore
  8. Priority of formats
  9. Format takes precedence over quality
  10. Enable Youtube DASH streams
    1. Muxing exceptions
    2. Audio-only output
  11. Maximum width of the video
  12. Prefer 3D videos


Preferred video resolution

What video resolution to use by default. So if filter selects quality automatically, it will be played. If Manual quality selection is used, it will be selected initially.

If there are no such resolution, filter will use video with resolution nearest to it. For example if you select 1080p quality and page contains qualities only up to 720p, then 720p quality will be used.

If you select Smallest Size, filter will use the smallest available video file. If files sizes are unknown, will be used indirect signs (lower resolution etc).

Preferred audio bitrate

What audio bitrate to use in video and when Audio-only output is turned on.

In case of video playback filter first selects most appropriate video and only then starts to select audio. This means that if most appropriate by this option audio is in Muxing exceptions with selected video, this audio will be ignored.

Option value Auto means select bitrate appropriate for specific video resolution. Depending on resolution it will be set to next value: 144p: 32 kbps, 240p: 64 kbps, 360p-480p: 128 kbps, 720p: 256 kbps, 1080p+: best available.

Prefer high frame rate videos

When the page contains both qualities with regular frame rate and high frame rate, this option controls which set of qualities to use.

Note, quality is selected only after video resolution comparison. So if preferred resolution does not have high frame rate, and some other resolution has it, then still the preferred resolution will be chosen.

In quality description the video with high frame rate is appended with 'HFR' string.

Prefer high dynamic range videos

When the page contains both qualities with regular video and high dynamic range video (HDR), this option controls which set of qualities to use.

Note, quality is selected only after video resolution comparison. So if preferred resolution does not have high dynamic range, and some other resolution has it, then still the preferred resolution will be chosen.

In quality description the video with high dynamic range is appended with 'HDR' string.

Download subtitles

Youtube and Dailymotion clips can have external subtitles. More about this you can read on Subtitles support page.

Using this option can be selected any set of subtitles. For every kind of subtitles can be selected its own set.

Subtitles outside this set will be excluded from available subtitles when opening the clip. Note, all subtitles are downloaded at playback start. Therefore it can take much longer if large set of subtitles is selected.

Subtitle becomes selected if its language tag contains any of language tags specified within these options. 'Contains' means substring match, case-sensitive.

If some language tag is absent or you want more specific match (e.g. 'en-GB' instead of just 'en') you can add your own tag using option menu Custom Add. By click on it appears window asking to enter new tag:

Adding new language tag

Language tag has strict format so Add button will remain disabled until it is properly entered. It is required to have language code and optional script and country codes separated by hyphen. Country code and first letter of script code should be uppercase, all other lowercase.

Manual quality selection

This option controls when to show Manual quality selection window.

If there is selected If holding XX key then you need to press this XX key before click OK (or similar button when you adding and URL), and hold this key until manual quality selection window will appear.

If there is selected Always then window will appear every time when filter opens a clip. Note, it is up to video player when and for what purpose to ask filter to open a clip. Player can do that not necessarily only when opening the clip, or not necessarily only once. Filter cannot determine for what purpose clip is opened so it will show quality selection window every time. Therefore if using Always option you see quality selection window too often or in an unexpected moment, consider using one of If holding... options.

Formats to ignore

List of formats to be ignored at analysis. So they will never be selected for playback automatically. Via manual quality selection it is still possible to use them.

Format in context of this option means file extension like it is shown in quality selection window. To enter several formats separate them by semicolon e.g. mp4;opus.

When video format is entered there will be ignored both regular and adaptive streams. To ignore only adaptive streams append format with -vo suffix e.g. mp4-vo.

When audio formats are entered e.g. ogg;opus, they will be ignored at audio-only playback. If you want to ignore some audio as part of the video, pretend it with '+' character e.g. +m4a;+ogg.

Priority of formats

Using this option you can specify preferred formats. Unless Format takes precedence over quality is checked, this option takes action only if there need to compare two media files with the same quality.

To enter several formats separate them by semicolon e.g. formatspec1;formatspec2. In case of audio formatspec is just format name (e.g. opus).

In case of video formatspec is either video format name (e.g. mp4) or formats pair (video+audio). In the latter case one of two parts can be omitted (retaining '+' character). Also in this case VO video should be specified explicitly (by appending format with '-vo' string).

Examples may better describe all this mess:

Format takes precedence over quality

By default, when two formats are compared, Priority of formats is used only after quality comparison. Thus it is used only when qualities of video and audio streams are equal. This is not the way how some people may expect or would like it to work.

This option changes comparison workflow part described above. When it is checked, formats entered in Priority of formats will be selected regardless of their quality.

Enable Youtube DASH streams

Allow the filter to report adaptive streams to the player. Best quality is available only using these streams. However not all players support them (more precisely - the way how they are provided by the filter), so this option is disabled by default.

Muxing exceptions

When need to download video file and the clip page contains adaptive streams, program creates combination of every video and audio stream that it finds. Resulting 'pseudo' file then is used in comparison like any other video file.

Not every video and audio stream can be muxed together. This possibility depends on media file format and codecs of the video and audio stream. For example, WebM is not designed to store AAC streams, Opus is not currently supported by MP4 container etc. So some streams combinations should be avoided.

This option contains pairs of formats which should not be muxed together. Expected option value is format1+format2, for example mp4+ogg. To enter several pairs separate them by semicolon.

Audio-only output

When using adaptive streams, video and audio streams are available within separate files. So if you want to listen an audio and don't actually need a video, it is possible to omit video downloading. This option enables such behavior.

Maximum width of the video

There can be situations when it is need to limit maximum width (for example to retain hardware acceleration). And since Preferred video resolution refers to video height, it is not always enough for video frame size limiting. For example 1920x1080 is 1080p with 16:9 aspect ratio. And 1080p with 21:9 aspect ratio will be 2560x1080 (example).

So when width is important too, this option can be used to limit it. Value 0 (zero) means no limit.

Prefer 3D videos

When the clip contains both 3D and non-3D variants of the video (and only in this case), this option controls which set of videos to use. The opposite set will be ignored. Option does nothing if page contains only 3D videos or only non-3D videos.

This setting was significant in the past. However at this time it looks like there are no more clips containing both 3D and non-3D video on Youtube.

In quality description 3D videos are appended with '3D' string.

Help Options Quality