12 Jul 2019

Help

  1. Info
  2. Formats
  3. Log
  4. General
  5. Network
  6. Maintenance

Property pages

Like the most DirectShow filters Youtube Source has property pages. This is standard way for DirectShow filters to provide user interface so it is usually exposed by video players. For example, player may provide access to property pages of the filters in graph via context menu (example screenshot).

Filter has next property pages: Info, Formats - for video information; Log - for diagnostics; General, Network, Maintenance - for configuration.

Property pages can also be invoked from start menu or by configure.bat script if you use standalone filters. In this case pages Info and Formats are not displayed since there is no video to describe.

Info

Info page consists of a list control containing all properties that filter was able to get for this video (e.g. title or upload date) and a read-only edit box containing video description from the site.

Formats

Formats page has a list of media streams and subtitles found on the page. Using context menu Properties or by hovering info icon one can get full list of everything that filter knows for particular stream (like media container properties, streams and codecs).

Page also has Filter combo box using which one can filter listed formats using various criteria.

List items have check boxes. Checked items represent streams that were selected at the video opening. Check boxes state is read-only.

Log

This property page serves the same function as popup page of the same name and is described in Popup pages topic.

General

User Interface

Show icon in system tray

Show icon in system tray when filter is is use by the video player.

This gives the filter possibility to provide additional features through this icon. Notification about new version is possible only when system tray icon is enabled. Popup pages are also accessible only via context menu of system tray icon.

Controls which Popup pages should be shown automatically right after the filter is created by video player.

Analysis

Probe each stream found during the analysis

Many sites provide multiple qualities for every video. To select most appropriate quality program obviously must know properties of existing qualities. This option control whether it should use only qualities info available on the page or it must probe each quality and thus get info right from origin.

Probe limit per stream (milliseconds)

When probing is allowed, filters downloads part of each stream found on the page until it retrieves info about the stream quality or limit specified in this option is reached.

Quality

Manual selection

This option controls when to show Manual quality selection window.

If there is selected If holding the ... key then you need to hold this key when adding URL to the player.

If there is selected Always then window will appear every time filter opens a video.

Note, it is up to the video player when and for what reason to ask filter to open an URL. Player can do that not necessarily only when opening a video, or not necessarily only once. Filter cannot determine for what purpose URL is being opened so it will show quality selection window every time. Therefore if with option Always you face quality selection window too often or at unexpected moments, consider using one of If holding... options.

Main source, Extra source

These options cover video and audio quality selected by the filter. Youtube and many other sites have more than one quality for single video so via these options you say the filter what quality to choose. Read more in Criteria topic.

Subtitles

Option controls what subtitles should be downloaded and provided by the filter in case they are available on the video page. Read more in Subtitles support topic.

Network

Main

Maximum reconnection delay (seconds)

When some problem with Internet connection occurs, filter tries to reconnect to the server. If connection problem is temporary this can help to resolve it.

This option controls how long reconnection attempts should be performed.

Retry if no data received for (seconds)

If no data was received for this period of seconds, initiate reconnection retry as it would be done on connection problems.

User-Agent_string

Override User-Agent HTTP header used by the filter.

Temporary directory

Directory where to place temporary files. By default filter uses Windows TEMP directory.

Click Browse menu item to select specific temporary directory. For example on non-system disk partition, if system partition (where Windows TEMP is placed) has not much space. If custom directory is already selected, it is listed above the Browse item. To select a different directory, click on the Browse item again.

Download media data independently from playback

If this option is checked, filter performs media file download independently of playback. So it continues downloading even when playback is paused.

This approach is useful when you have slow or unstable Internet connection (so playback is stuttering), or when you need to seek a lot within a file. However if all these cases are not about you, and usually you do not watch whole video, it may end up with bandwidth overuse since a lot of downloaded data eventually will be not watched.

When this option is unchecked, filter downloads only part of data that is about to be played.

Filter caches downloaded data in temporary directory regardless of the state of this option and never re-downloads the same data again. Caching is well visualized by Activity popup page.

Proxy

When a Proxy server is used for Internet connection, the program allows (well, and forces) to specify it separately from the system settings.

Maintenance

Filter Binary

Check for updates on startup

Automatically check for updates after the filter is added to the graph. If new version is available filter indicates this by tooltip in system tray (example).

Notification re-appears not earlier than 24 hours after previous one.

Checking period

Perform next check for updates not earlier than after number of days specified via this option. Also if new version is already found, further checking for updates is not performed.

Check for beta versions when running stable version

Often before releasing stable version there is available beta version. You can use this option to get new features earlier, within beta version, by the price of possible instability. When enabled it notifies about new beta versions the same way as it notifies about new stable versions.

If beta version is already installed, filter checks for beta versions regardless of this option.

Third-party Binaries

Using this group of options you can maintain third-party binaries used by the filter. They are described in separate topic.

Help Property pages