[icecast-dev] Patches - Was: Stream metadata settings

[Melanie]

Here I go again.

This is the second patch, it adds the ability to override some YP settings 
on the server.

<yp-override>1</yp-override>

If this is not set, we don't override the yp flag.

<yp-public>1</yp-public>

When this is set, the stream will be public or non public, according to 
it's content. This only works when yp-override is set. It allows to 
suppress yp reporting or to force it, or leave it under control of the 
source.

<yp-name>MyRadio</yp-name>

This will overwrite the name given by the source with the name specified 
here.

<yp-url><a href="http://www.radio.com/myradio.html</yp-url">http://www.radio.com/myradio.html</yp-url</a>>

This will force a specific URL to be listed with the YP server. Omit to let 
the source control this.

<yp-genre>Mixed</yp-genre>

This will force a genre, as with all yp-* options, omit for the old 
behavior.

<yp-desc>My Super Duper radio station</yp-desc>

Override and force the station comment.

<yp-report-as>/myradio.ogg</yp-report-as>

This will override the URL given to the YP server for stream listening.
Now, before there is an outcry again, let me explain this one:

Assume you have a mountpoint. This mountpoint has a fallback. Now, your 
main mountpoint's source disconnects. It's YP information is removed. So, 
you're no longer listed.
Now, if the fallback is public, it would either always appear side by side 
with your main stream, but, even worse, if it's a no-mount, it would be 
useless. Nobody could listen to it, ever.
report-as solves this: If a fallback is set to report as the name of it's 
top-level stream, it will not register with YP unless it becomes active, 
becomes the highest level active stream in it's chain.
This will ensure that, even when there is a break in transmission or you're 
just playing your station jingle, your station will remain listed in YP, by 
the correct (primary) mount name.

<mount>
   <mount-name>/station.ogg</mount-name>
   <yp-override>1</yp-override>
   <yp-public>1</yp-public>
   <fallback-mount>/fallback.ogg</fallback>
</mount>

<mount>
   <mount-name>/fallback.ogg</mount-name>
   <no-mount>1</no-mount>
   <yp-override>1</yp-override>
   <yp-public>1</yp-public>
   <yp-report-as>/station.ogg</yp-report-as>
</mount>

This will keep your stream online, connectable and listed correctly 
whenever at least one of the streams has a source, building on the concept 
that a stream and it's fallback(s) are logically one station and should be 
seen as a single URL from the outside world.

Melanie
--- >8 ----
List archives:  http://www.xiph.org/archives/
icecast project homepage: http://www.icecast.org/
To unsubscribe from this list, send a message to 'icecast-dev-request at xiph.org'
containing only the word 'unsubscribe' in the body.  No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.