From: Kyle Robbertze Date: Fri, 26 Sep 2025 09:50:00 +0100 Subject: Remove docs related to non-free optional dependencies --- docs/glasscoder.xml.in | 343 ++++--------------------------------------------- 1 file changed, 22 insertions(+), 321 deletions(-) diff --git a/docs/glasscoder.xml.in b/docs/glasscoder.xml.in index ccd8468..f3cddf8 100644 --- a/docs/glasscoder.xml.in +++ b/docs/glasscoder.xml.in @@ -90,7 +90,7 @@ - The number of audio channels to use. Valid values are + The number of audio channels to use. Valid values are 1 or 2. Default value is 2. @@ -123,20 +123,6 @@ -
- - - - ASIHPI - - - - AudioScience HPI. - - - - -
@@ -178,20 +164,6 @@ VORBIS. Valid fmt values are: -
- - - - AACP - - - - MPEG-4 Advanced Audio Coding "Plus" (High Efficiency Profile) - - - - -
@@ -337,7 +309,7 @@ Password=<password> Prepend string to messages sent to the - syslog service (see the + syslog service (see the option, below). Useful for disambiguating messages from multiple glasscoder1 instances. @@ -529,7 +501,7 @@ Password=<password> Proxy Connections section of the glasscoder-ipc7 man page. The default is to create no UNIX socket. This setting is used only - by the IceStreamer server. + by the IceStreamer server. @@ -555,7 +527,7 @@ Password=<password> Run the command cmd when the connection enters the connected state. - + @@ -570,7 +542,7 @@ Password=<password> Used only by the IceStreamer server in conjunction with the FILE audio device. Default value is 0 --i.e. start the transport immediately. - + @@ -680,7 +652,7 @@ Password=<password>
- + url @@ -774,7 +746,7 @@ Password=<password> The ICQ ID to associate with the stream. There is no default value. This setting is used only by Shoutcast servers. - + @@ -824,7 +796,7 @@ Password=<password> The URL to show for a page giving more information about the stream. There is no default value. This setting is used only by Icecast and Shoutcast servers, but is ignored by Shoutcast v2 servers. - + @@ -857,9 +829,9 @@ Password=<password> - Advanced Linux Sound Architecture + Advanced Linux Sound Architecture (ALSA) - + @@ -878,285 +850,6 @@ Password=<password> - - - AudioScience HPI - (=ASIHPI) - - - - - - index - - - - The index number of the audio adapter to use. - - - - - - index - - - - The number of the input audio stream to use on the specified adapter. - - - - - - gain - - - - The gain to apply to the input audio on the specified adapter in - dB. Valid values are -100 to - +20 inclusive. Default value is - 0. - - - - - - mode - - - - The channel mode for the input audio on the specified adapter. - The default value is NORMAL. Valid values - are: - -
- - - - NORMAL - - - - Left signal goes to left channel, right signal goes to - right channel. - - - - - - SWAP - - - - Left signal goes to right channel, right signal goes to - left channel. - - - - - - LEFT - - - - Left signal goes to both left and right channels. - - - - - - RIGHT - - - - Right signal goes to both left and right channels. - - - - -
- - - - - src-node - - - - The input source to use on the specified adapter. See the - HPI Source Nodes section below - for the list of valid src-node - values. The default value is LINEIN. - - - - - - src-node - - - - The input type to use on the specified adapter. See the - HPI Source Nodes section below - for the list of valid src-node - values. The default value is LINEIN. - - - - - - HPI Source Nodes - - - - The following values can used for the - and - options above: - - - - - NONE - - - OSTREAM - - - - Internal output stream - - - - - - LINEIN - - - - Generic input signal - - - - - - AESEBU - - - - AES3 digital input - - - - - - TUNER - - - - Tuner - - - - - - RF - - - - RF input - - - - - - CLOCK - - - - Clock source - - - - - - BITSTREAM - - - - Raw bitstream - - - - - - MIC - - - - Microphone - - - - - - COBRANET - - - - CobraNet - - - - - - ANALOG - - - - Analog input - - - - - - ADAPTER - - - - Adapter - - - - - - RTP - - - INTERNAL - - - - Device internal - - - - - - AVB - - - - AVB input - - - - - - - - - - - Direct File Streaming @@ -1360,7 +1053,7 @@ Password=<password> Description - Specified by the + Specified by the option. @@ -1369,7 +1062,7 @@ Password=<password> URL - Should be a link to content related to the stream. Specified by the + Should be a link to content related to the stream. Specified by the option. @@ -1473,7 +1166,7 @@ Password=<password> URL - Should be a link to content related to the stream. Specified by the + Should be a link to content related to the stream. Specified by the option. @@ -1658,10 +1351,18 @@ Password=<password> +Notes + + The Debian version of GlassCoder does not support the MPEG-4 HE-AAC+ + encoding, as it is non-free. The AudioScience HPI source device is + excluded for the same reason. + + + Bugs Never use the option; it allows credentials to - be seen by other users on the system. Use the + be seen by other users on the system. Use the option to specify server credentials instead.