Difference between revisions of "Foobar2000:Preferences:UPnP MediaRenderer Output"

From Hydrogenaudio Knowledgebase
Jump to: navigation, search
(Work in progress)
Line 10: Line 10:
 
Each section contains options that apply to a specific range of devices.
 
Each section contains options that apply to a specific range of devices.
  
A section may contain lines defining which devices it applies to: manufacturer, model and name.
+
A section may contain lines defining which devices it applies to: <code>manufacturer</code>, <code>model</code> and <code>name</code>.
  
 
For an example:
 
For an example:
  
manufacturer=Sony Corporation
+
<code>manufacturer=Sony Corporation<br/>
 
+
model=HT-XT3</code>
model=HT-XT3
+
  
 
.. means that this section applies only to device model "HT-XT3" by "Sony Corporation".
 
.. means that this section applies only to device model "HT-XT3" by "Sony Corporation".
  
If you specify multiple manufacturers/models/names per section, the section will apply to each of the possible combinations.
+
If you specify multiple <code>manufacturer</code>/<code>model</code>/<code>name</code> entries per section, the section will apply to each of the possible combinations.
  
 
=== Settings ===
 
=== Settings ===
  
stream-title
+
* <code>stream-title</code>
  
Controls the stream title sent to the device. Typically set in global settings.
+
Controls the stream title sent to the device. Typically set in global settings. Can be overridden to sent different value to different devices.
  
preferred-format
+
* <code>preferred-format</code>
  
Controls the preferred data format to be sent to the device. Valid values are: FLAC, LPCM and WAV. Note that WAV format doesn't support infinite length content without hacks and should be used only if there are no better alternatives; playback may stop abnormally after a few hours of playback due to this.
+
Controls the preferred data format to be sent to the device. Valid values are: FLAC, LPCM and WAV. If the preferred format cannot be used (not supported by the device, or the requested bitdepth/channels are not supported), other formats will be attempted.
  
supports-FLAC
+
Note that WAV format doesn't support infinite length content without hacks and should be used only if there are no better alternatives; playback may stop abnormally after a few hours of playback due to this.
 +
 
 +
* <code>supports-FLAC</code>
  
 
Set to 'false' to disable sending FLAC to this device, even if the device claims to support it. Some devices claim to support FLAC but fail to play a FLAC live stream or have other bugs affecting FLAC playback.
 
Set to 'false' to disable sending FLAC to this device, even if the device claims to support it. Some devices claim to support FLAC but fail to play a FLAC live stream or have other bugs affecting FLAC playback.
  
supports-WAV
+
Note that you can only prevent FLAC from being sent, this setting will not cause FLAC to be sent to a device that doesn't claim to support it.
 +
 
 +
* <code>supports-WAV</code>
  
 
Set to 'false' to disable sending WAV to this device, even if the device claims to support it. Some devices claim to support WAV but have bugs affecting WAV playback.
 
Set to 'false' to disable sending WAV to this device, even if the device claims to support it. Some devices claim to support WAV but have bugs affecting WAV playback.
  
supports-LPCM
+
Note that you can only prevent WAV from being sent, this setting will not cause WAV to be sent to a device that doesn't claim to support it.
 +
 
 +
* <code>supports-LPCM</code>
  
 
Set to 'false' to disable sending LPCM to this device, even if the device claims to support it. Some devices claim to support LPCM but have bugs affecting LPCM playback.
 
Set to 'false' to disable sending LPCM to this device, even if the device claims to support it. Some devices claim to support LPCM but have bugs affecting LPCM playback.
  
supports-pause
+
Note that you can only prevent LPCM from being sent, this setting will not cause LPCM to be sent to a device that doesn't claim to support it.
 +
 
 +
* <code>supports-pause</code>
  
 
Set to 'false' to work around bugs related to pausing playback; a stop command will be sent to the device instead of pause.
 
Set to 'false' to work around bugs related to pausing playback; a stop command will be sent to the device instead of pause.
  
zero-length-WAV
+
* <code>zero-length-WAV</code>
  
 
Some devices treat WAV files with zero length in headers as unknown-length and read them indefinitely, which is desired in this case. However this a hack and can't be used with every device out there. Known to work with Linn devices.
 
Some devices treat WAV files with zero length in headers as unknown-length and read them indefinitely, which is desired in this case. However this a hack and can't be used with every device out there. Known to work with Linn devices.
  
send-accept-ranges
+
* <code>send-accept-ranges</code>
  
 
Some devices dislike "accept-ranges: none" HTTP header, set this to 'false' to suppress this.
 
Some devices dislike "accept-ranges: none" HTTP header, set this to 'false' to suppress this.
  
supports-infinite-length
+
* <code>supports-infinite-length</code>
  
 
Set to 'true' if the device supports infinite-length LPCM streams.
 
Set to 'true' if the device supports infinite-length LPCM streams.
  
supports-chunked
+
* <code>supports-chunked</code>
  
 
Set to 'true' if the device supports HTTP chunked encoding.
 
Set to 'true' if the device supports HTTP chunked encoding.
  
hidden
+
* <code>hidden</code>
  
 
Set to 'true' to hide matching devices from foobar2000 output device list.
 
Set to 'true' to hide matching devices from foobar2000 output device list.
 +
 +
=== Settings storage location ===
 +
 +
The above settings are stored in a file named foo_out_upnp-config.txt in your foobar2000 profile folder.
  
 
== Found devices ==
 
== Found devices ==
 
Shows a list of currently known devices present on the network.
 
Shows a list of currently known devices present on the network.
 
Double click a device to see additional information about it.
 
Double click a device to see additional information about it.
 +
 +
== Console logging ==
 +
Toggle this to enable verbose debug logging of all actions performed by the component, for troubleshooting.

Revision as of 14:45, 30 March 2019

Summary

This page provides tweaking/troubleshooting options for the UPnP MediaRenderer Output component.

Configuration

Controls all settings of the component, including device-specific workarounds.

Sections

The options are grouped into sections, delimited by blank lines.

Each section contains options that apply to a specific range of devices.

A section may contain lines defining which devices it applies to: manufacturer, model and name.

For an example:

manufacturer=Sony Corporation
model=HT-XT3

.. means that this section applies only to device model "HT-XT3" by "Sony Corporation".

If you specify multiple manufacturer/model/name entries per section, the section will apply to each of the possible combinations.

Settings

  • stream-title

Controls the stream title sent to the device. Typically set in global settings. Can be overridden to sent different value to different devices.

  • preferred-format

Controls the preferred data format to be sent to the device. Valid values are: FLAC, LPCM and WAV. If the preferred format cannot be used (not supported by the device, or the requested bitdepth/channels are not supported), other formats will be attempted.

Note that WAV format doesn't support infinite length content without hacks and should be used only if there are no better alternatives; playback may stop abnormally after a few hours of playback due to this.

  • supports-FLAC

Set to 'false' to disable sending FLAC to this device, even if the device claims to support it. Some devices claim to support FLAC but fail to play a FLAC live stream or have other bugs affecting FLAC playback.

Note that you can only prevent FLAC from being sent, this setting will not cause FLAC to be sent to a device that doesn't claim to support it.

  • supports-WAV

Set to 'false' to disable sending WAV to this device, even if the device claims to support it. Some devices claim to support WAV but have bugs affecting WAV playback.

Note that you can only prevent WAV from being sent, this setting will not cause WAV to be sent to a device that doesn't claim to support it.

  • supports-LPCM

Set to 'false' to disable sending LPCM to this device, even if the device claims to support it. Some devices claim to support LPCM but have bugs affecting LPCM playback.

Note that you can only prevent LPCM from being sent, this setting will not cause LPCM to be sent to a device that doesn't claim to support it.

  • supports-pause

Set to 'false' to work around bugs related to pausing playback; a stop command will be sent to the device instead of pause.

  • zero-length-WAV

Some devices treat WAV files with zero length in headers as unknown-length and read them indefinitely, which is desired in this case. However this a hack and can't be used with every device out there. Known to work with Linn devices.

  • send-accept-ranges

Some devices dislike "accept-ranges: none" HTTP header, set this to 'false' to suppress this.

  • supports-infinite-length

Set to 'true' if the device supports infinite-length LPCM streams.

  • supports-chunked

Set to 'true' if the device supports HTTP chunked encoding.

  • hidden

Set to 'true' to hide matching devices from foobar2000 output device list.

Settings storage location

The above settings are stored in a file named foo_out_upnp-config.txt in your foobar2000 profile folder.

Found devices

Shows a list of currently known devices present on the network. Double click a device to see additional information about it.

Console logging

Toggle this to enable verbose debug logging of all actions performed by the component, for troubleshooting.