14 Apr 2017

Help Basic

  1. Component variants
  2. Protocol registration
  3. Linux support
  4. Windows XP support
  5. Alternative SSL backend

Integration

Component variants

Component has two variants to download: standalone and preconfigured. Both variants have everything that is needed to play audio from the supported sites. Preconfigured variant additionally contains everything that is needed to play video.

Need to understand that these are not different component versions: component binary file (i.e. foo_youtube.dll) in all variants is identical.

Preconfigured variant just already contains LAV Filters (need for video decoding) and xy-VSFilter (need to display subtitles in the video). Standalone variant can be manually configured to behave the same as preconfigured (using Maintenance tab of component preferences). Also that is not even necessary if these filters are registered in the system: internal LAV Filters and xy-VSFilter are used only if they are not found in the system or version of local filter is greater than version of the filter installed in the system.

Protocol registration

If one wants to associate foobar2000 with custom protocols used by the component, then this is possible for Windows Vista and above. Component exposes its protocols (currently they are 3dydfy:// and 3dydfy-search://) so they can be associated with the program using Control Panel Default Programs.

Linux support

Component works fine under Wine. Everything except video playback.

There can be an error Security Error when adding URL using Add location... or an error SSL connect error (35) when playing the clip. One of possible reasons is lack of libgnutls library. Wine needs it to provide schannel functionality which is its turn is used to access HTTPS by foobar2000 and component. This library is an optional dependency for Wine (or at least that is so on some distributions) so it could be not installed automatically.

To ensure that required libgnutls library is missing, you can run foobar2000 from terminal, i.e. do something like

wine ~/.wine.drive_c/"Program Files (x86)"/foobar2000/foobar2000.exe

And check output in terminal window. One of top lines there will say something like

TODO

Installation of required libgnutls library package should resolve the problem. Package name differs across Linux distributions and Wine versions so no exact name here.

As other solution, alternative SSL backend can be configured. But this may solve the problem only partially because it fixes issue for component, not for foobar2000 in general. E.g. Add location... may still not work.

Windows XP support

Minimum supported Windows version is XP SP2. Non-SSE-capable CPUs are also supported.

Note, as of February 2017 it looks like Youtube switched to more secured HTTPS version that is not supported by Windows XP native SSL backend. If you are getting an error containing SSL connect error (35), configure alternative SSL backend.

Note for XP SP2 users (not relevant for SP3). Latest LAV Video filter does not work under SP2. So to make video playback work, download LAV Filters 0.59.1 and select LAVVideo.ax from it in component preferences Maintenance LAV Video (or register that filter in the system). Don't do that with LAV Splitter - latest version (0.69 at the moment of writing) does work under SP2. And MP4 DASH seeking (which is duty of the splitter) has appeared only in some of 0.6X versions.

Alternative SSL backend

Component uses libcurl for HTTP/HTTPS transfers. In addition to internal libcurl it is possible to specify external libcurl library. Primarily that is done to be able to use different SSL backend (in internal libcurl is used Windows native SSL backend).

To apply external libcurl library, select it in component preferences Maintenance libcurl.

Ready to use libcurl with OpenSSL is available on Download page. You may also experiment with other existing variants that are available on cURL download page.

Help Basic Integration