XiphWiki - User contributions [en]

Icecast Server/Installing latest version (official Xiph repositories)

2018-11-07T09:01:55Z

Dm8tbr: update available and supported repositories

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Step 1: Add the repository ====
This expects that you have '''sudo''' installed. If not, open a root shell and run the '''echo''' command directly.

Copy and paste the command for your distribution release and make sure that it's executed as '''one''' line!

{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|Debian Testing
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_Testing/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_Testing/ repository]
|
|-
|Debian 9.0 (stretch)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ repository]
|
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|LTS<ref name="ubuntu-lts"/>
|-
|Ubuntu 16.04 (xenial)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ repository]
|LTS<ref name="ubuntu-lts"/>
|-
|Ubuntu 18.04 (bionic)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_18.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_18.04/ repository]
|LTS<ref name="ubuntu-lts"/>!
|-
|Ubuntu 18.10 (cosmic)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_18.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_18.10/ repository]
|LTS<ref name="ubuntu-lts"/>!
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}

==== Step 2: Import the ''Multimedia'' signing key ====
You need to add the [http://icecast.org/multimedia-obs.key openSUSE OBS '''Multimedia''' signing key] as a Trusted Key to your system.

There are many ways to verify this key, e.g. by a simple web search.

After downloading the key, you can run this command to verify your copy:

<syntaxhighlight lang="bash">gpg multimedia-obs.key</syntaxhighlight>

It should yield:

pub rsa2048 2017-11-21 [SC] [expires: 2020-01-30]
<nowiki> 0E313DB7936B4E76E720065B77EC2301F23C6AA3</nowiki>
uid multimedia OBS Project <multimedia@build.opensuse.org>

Then you can add the key to your system's Trusted Keys using:

<syntaxhighlight lang="bash">sudo apt-key add multimedia-obs.key</syntaxhighlight>

The simplest way (but not very secure, since you're not checking the key) is to add the key with one command line:

<syntaxhighlight lang="bash">wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</syntaxhighlight>

==== Step 3: Update your repository index ====
<syntaxhighlight lang="bash">sudo apt-get update</syntaxhighlight>
==== Step 4: Install Icecast ====
<syntaxhighlight lang="bash">sudo apt-get install icecast2</syntaxhighlight>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 27
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_27 repository]
|
|-
|Fedora 28
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_28 repository]
|
|-
|Fedora Rawhide
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_Rawhide repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|SUSE Linux Enterprise 11 SP4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|SUSE Linux Enterprise 12 SP4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12_SP4 repository]
|
|-
|SUSE Linux Enterprise 15
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_15 repository]
|
|-
|openSUSE Leap 42.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.3 repository]
|
|-
|openSUSE Leap 15.0
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_15.0 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

== Footnotes ==
<references/>
[[Category: Icecast]]

Icecast Server/known reverse proxy restrictions

2018-08-19T07:53:42Z

Dm8tbr: added SOURCE and PUT restrictions

This page lists known problems of latest released Icecast when operating behind a reverse proxy:

* access.log will always only show the IP address of the reverse proxy instead of listener IP address.
* internal XML tree will only show the IP address of the reverse proxy instead of listener IP address. Both for source clients and for listener clients.
* virtual playlist files will break. (Only if proxy server is configured incorrectly.)
* authentication helper will break. (Only if proxy server is configured incorrectly.)
* HTTP SOURCE connections are very likely to break
* HTTP PUT connections might exhibit problems if the proxying server expects and processes chunked encoding. Chunked encoding will be part of Icecast 2.5
* …

See also [[Icecast_Server/known_https_restrictions|known HTTPS restrictions]], if reverse proxy terminates https.

Icecast Server/known https restrictions

2018-07-12T12:08:44Z

Dm8tbr: ph3-listen-sockets was merged into master

This page lists known problems of latest released Icecast when operating with TLS enabled.

* 'listenurl' in the internal XML status representation is not protocol aware and will always use 'http' + global hostname (default: "localhost") and port (default: first listen-socket) (code addressing this was merged into ''master'' branch)
* Virtual playlist files don't work (code addressing this was merged into ''master'' branch)
* Authentication helper doesn't work (code addressing this was merged into ''master'' branch)
* Certificate reload is not implemented in 2.4.x. Icecast2 2.4.x needs to be restarted to reload the certificate. (is being developed in ''master'' branch, releases: ''v2.5.0-beta2'')
* YP client code only works for plain HTTP streams.
* …

== TLS Mode compatibility charts ==
The following tables list Icecast configuration settings (horizontal) versus client settings (vertical).

Note: While '''auto''' mode may connect using TLS, it will not establish a secure connection. '''auto_no_plain''' will ensure a secure connection.

=== Icecast2 2.4.x ===
{| class="wikitable"
! !! 0 !! 1
|-
! colspan="3" | libshout
|-
! disabled
| Yes || No
|-
! auto
| Yes || Yes
|-
! auto_no_plain
| No || Yes
|-
! [https://tools.ietf.org/html/rfc2817 RFC2817]
| No || No
|-
! [https://tools.ietf.org/html/rfc2818 RFC2818]
| No || Yes
|}

=== Icecast2 2.5.x (branch "master") ===
Note: for truth values the following keywords can be used in the configuration: 0, false, no, off, 1, true, yes, on

{| class="wikitable"
!
! colspan="2" | TLS not configured
! colspan="5" | TLS configured
|-
!
! disabled !! auto, false
! disabled !! auto, false !! auto_no_plain !! rfc2817 !! rfc2818, true
|-
! colspan="8" | libshout
|-
! disabled
| Yes || Yes || Yes || Yes || No || No || No
|-
! auto
| Yes || Yes || Yes || Yes || Yes || Yes || Yes
|-
! auto_no_plain
| No || No || No || Yes || Yes || Yes || Yes
|-
! [https://tools.ietf.org/html/rfc2817 RFC2817]
| No || No || No || Yes || Yes || Yes || No
|-
! [https://tools.ietf.org/html/rfc2818 RFC2818]
| No || No || No || Yes || Yes || No || Yes
|}

[[Category:Icecast]]

Icecast Server/known https restrictions

2018-05-19T11:45:11Z

Dm8tbr: clarify wording

This page lists known problems of latest released Icecast when operating with TLS enabled.

* 'listenurl' in the internal XML status representation is not protocol aware and will always use 'http' + global hostname (default: "localhost") and port (default: first listen-socket) (is being developed in branch ''ph3-listen-sockets'')
* Virtual playlist files don't work (is being developed in branch ''ph3-listen-sockets'')
* Authentication helper doesn't work (is being developed in branch ''ph3-listen-sockets'')
* Certificate reload is not implemented in 2.4.x. Icecast2 2.4.x needs to be restarted to reload the certificate. (is being developed in ''master'' branch, releases: ''v2.5.0-beta2'')
* YP client code only works for plain HTTP streams.
* …

== TLS Mode compatibility charts ==
The following tables list Icecast configuration settings (horizontal) versus client settings (vertical).

Note: While '''auto''' mode may connect using TLS, it will not establish a secure connection. '''auto_no_plain''' will ensure a secure connection.

=== Icecast2 2.4.x ===
{| class="wikitable"
! !! 0 !! 1
|-
! colspan="3" | libshout
|-
! disabled
| Yes || No
|-
! auto
| Yes || Yes
|-
! auto_no_plain
| No || Yes
|-
! [https://tools.ietf.org/html/rfc2817 RFC2817]
| No || No
|-
! [https://tools.ietf.org/html/rfc2818 RFC2818]
| No || Yes
|}

=== Icecast2 2.5.x (branch "master") ===
Note: for truth values the following keywords can be used in the configuration: 0, false, no, off, 1, true, yes, on

{| class="wikitable"
!
! colspan="2" | TLS not configured
! colspan="5" | TLS configured
|-
!
! disabled !! auto, false
! disabled !! auto, false !! auto_no_plain !! rfc2817 !! rfc2818, true
|-
! colspan="8" | libshout
|-
! disabled
| Yes || Yes || Yes || Yes || No || No || No
|-
! auto
| Yes || Yes || Yes || Yes || Yes || Yes || Yes
|-
! auto_no_plain
| No || No || No || Yes || Yes || Yes || Yes
|-
! [https://tools.ietf.org/html/rfc2817 RFC2817]
| No || No || No || Yes || Yes || Yes || No
|-
! [https://tools.ietf.org/html/rfc2818 RFC2818]
| No || No || No || Yes || Yes || No || Yes
|}

[[Category:Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2018-05-19T11:10:17Z

Dm8tbr: Prune EoL releases

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Step 1: Add the repository ====
This expects that you have '''sudo''' installed. If not, open a root shell and run the '''echo''' command directly.

Copy and paste the command for your distribution release and make sure that it's executed as '''one''' line!

{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|Debian Testing
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_Testing/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_Testing/ repository]
|
|-
|Debian 9.0 (stretch)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ repository]
|
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|LTS<ref name="ubuntu-lts"/>
|-
|Ubuntu 16.04 (xenial)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ repository]
|LTS<ref name="ubuntu-lts"/>
|-
|Ubuntu 17.10 (artful)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_17.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_17.10/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 18.04 (bionic)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_18.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_18.04/ repository]
|LTS<ref name="ubuntu-lts"/>!
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}

==== Step 2: Import the ''Multimedia'' signing key ====
You need to add the [http://icecast.org/multimedia-obs.key openSUSE OBS '''Multimedia''' signing key] as a Trusted Key to your system.

There are many ways to verify this key, e.g. by a simple web search.

After downloading the key, you can run this command to verify your copy:

<syntaxhighlight lang="bash">gpg multimedia-obs.key</syntaxhighlight>

It should yield:

pub rsa2048 2017-11-21 [SC] [expires: 2020-01-30]
<nowiki> 0E313DB7936B4E76E720065B77EC2301F23C6AA3</nowiki>
uid multimedia OBS Project <multimedia@build.opensuse.org>

Then you can add the key to your system's Trusted Keys using:

<syntaxhighlight lang="bash">sudo apt-key add multimedia-obs.key</syntaxhighlight>

The simplest way (but not very secure, since you're not checking the key) is to add the key with one command line:

<syntaxhighlight lang="bash">wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</syntaxhighlight>

==== Step 3: Update your repository index ====
<syntaxhighlight lang="bash">sudo apt-get update</syntaxhighlight>
==== Step 4: Install Icecast ====
<syntaxhighlight lang="bash">sudo apt-get install icecast2</syntaxhighlight>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 24
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_24 repository]
|
|-
|Fedora 25
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_25 repository]
|
|-
|Fedora 26
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_26 repository]
|
|-
|Fedora 27
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_27 repository]
|
|-
|Fedora Rawhide
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_Rawhide repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|SUSE Linux Enterprise 11 SP3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11 SP4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE Leap 42.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.2 repository]
|
|-
|openSUSE Leap 42.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.3 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

== Footnotes ==
<references/>
[[Category: Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2017-11-28T10:33:35Z

Dm8tbr: Update list of currently supported repositories

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Step 1: Add the repository ====
This expects that you have '''sudo''' installed. If not, open a root shell and run the '''echo''' command directly.

Copy and paste the command for your distribution release and make sure that it's executed as '''one''' line!

{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|Debian Testing
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_Testing/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_Testing/ repository]
|
|-
|Debian 9.0 (stretch)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ repository]
|
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|
|-
|Ubuntu 15.04 (vivid)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 15.10 (wily)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>!
|-
|Ubuntu 16.04 (xenial)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ repository]
|LTS<ref name="ubuntu-lts"/>
|-
|Ubuntu 17.04 (zesty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_17.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_17.04/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 17.10 (artful)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_17.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_17.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>!
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_9.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}

==== Step 2: Import the ''Multimedia'' signing key ====
You need to add the [http://icecast.org/multimedia-obs.key openSUSE OBS '''Multimedia''' signing key] as a Trusted Key to your system.

There are many ways to verify this key, e.g. by a simple web search.

After downloading the key, you can run this command to verify your copy:

<syntaxhighlight lang="bash">gpg multimedia-obs.key</syntaxhighlight>

It should yield:

pub rsa2048 2017-11-21 [SC] [expires: 2020-01-30]
<nowiki> 0E313DB7936B4E76E720065B77EC2301F23C6AA3</nowiki>
uid multimedia OBS Project <multimedia@build.opensuse.org>

Then you can add the key to your system's Trusted Keys using:

<syntaxhighlight lang="bash">sudo apt-key add multimedia-obs.key</syntaxhighlight>

The simplest way (but not very secure, since you're not checking the key) is to add the key with one command line:

<syntaxhighlight lang="bash">wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</syntaxhighlight>

==== Step 3: Update your repository index ====
<syntaxhighlight lang="bash">sudo apt-get update</syntaxhighlight>
==== Step 4: Install Icecast ====
<syntaxhighlight lang="bash">sudo apt-get install icecast2</syntaxhighlight>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 24
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_24 repository]
|
|-
|Fedora 25
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_25 repository]
|
|-
|Fedora 26
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_26 repository]
|
|-
|Fedora 27
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_27 repository]
|
|-
|Fedora Rawhide
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_Rawhide repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|SUSE Linux Enterprise 11 SP3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11 SP4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE Leap 42.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.2 repository]
|
|-
|openSUSE Leap 42.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.3 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

== Footnotes ==
<references/>
[[Category: Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2017-11-21T17:46:50Z

Dm8tbr: update wiki with new multimedia signing key hash, fix formatting, remove Ubuntu 12.04, add 17.04 and 17.10

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Add the repository ====
This expects that you have ''sudo'' installed, if not, open a root shell and run the ''echo'' command directly.

Copy paste the command for your distribution release and make sure that it's executed as '''one''' line!
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Debian 6.0 (squeeze)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|
|-
|Ubuntu 15.04 (vivid)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 15.10 (wily)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>!
|-
|Ubuntu 16.04 (xenial)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ repository]
|LTS<ref name="ubuntu-lts"/>
|-
|Ubuntu 17.04 (zesty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_17.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_17.04/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 17.10 (artful)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_17.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_17.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>!
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}

==== Import the ''Multimedia'' signing key ====
You need to add the openSUSE OBS [http://icecast.org/multimedia-obs.key '''Multimedia''' signing key] as a trusted key to your system.
There are many ways to verify they key, e.g. by a simple web search. After downloading the key, you can run this command: 
<code><nowiki>gpg multimedia-obs.key</nowiki></code> 
It should yield:
pub rsa2048 2017-11-21 [SC] [expires: 2020-01-30]
<nowiki> 0E313DB7936B4E76E720065B77EC2301F23C6AA3</nowiki>
uid multimedia OBS Project <multimedia@build.opensuse.org>

Then you can import the key: 
<code><nowiki>sudo apt-key add multimedia-obs.key</nowiki></code> 

The most simple, but not necessarily most secure way to add the key with one command line is: 
<code><nowiki>wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</nowiki></code> 

==== Update repository index ====
<code><nowiki>sudo apt-get update</nowiki></code>
==== Install Icecast ====
<code><nowiki>sudo apt-get install icecast2</nowiki></code>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 22
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_22 repository]
|
|-
|Fedora 23
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_23 repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|SUSE Linux Enterprise 11.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11.4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE 13.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.1 repository]
|
|-
|openSUSE 13.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.2 repository]
|
|-
|openSUSE Leap 42.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.1 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

== Footnotes ==
<references/>
[[Category: Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2016-12-30T06:53:47Z

Dm8tbr: Reverted edits by Dm8tbr (talk) to last revision by MechanisM

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Add the repository ====
This expects that you have ''sudo'' installed, if not, open a root shell and run the ''echo'' command directly.

Copy paste the command for your distribution release and make sure that it's executed as '''one''' line!
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Debian 6.0 (squeeze)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ repository]
|
|-
|Ubuntu 12.04 (precise)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|
|-
|Ubuntu 15.04 (vivid)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 15.10 (wily)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>!
|-
|Ubuntu 16.04 (xenial)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ repository]
|LTS<ref name="ubuntu-lts"/>
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}

==== Import the ''Multimedia'' signing key ====
You need to add the openSUSE OBS [http://icecast.org/multimedia-obs.key '''Multimedia''' signing key] as a trusted key to your system.
There are many ways to verify they key, e.g. by a simple web search. After downloading the key, you can run this command: 
<code><nowiki>gpg multimedia-obs.key</nowiki></code> 
Should yield: 
<code><nowiki>pub 1024D/3A802234 2009-04-23 multimedia OBS Project <multimedia@build.opensuse.org></nowiki></code> 
Then you can import it: 
<code><nowiki>sudo apt-key add multimedia-obs.key</nowiki></code> 

The most simple, but not recommended way is: 
<code><nowiki>wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</nowiki></code> 

==== Update repository index ====
<code><nowiki>sudo apt-get update</nowiki></code>
==== Install Icecast ====
<code><nowiki>sudo apt-get install icecast2</nowiki></code>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 22
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_22 repository]
|
|-
|Fedora 23
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_23 repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|SUSE Linux Enterprise 11.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11.4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE 13.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.1 repository]
|
|-
|openSUSE 13.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.2 repository]
|
|-
|openSUSE Leap 42.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.1 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

== Footnotes ==
<references/>
[[Category: Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2016-11-15T14:57:20Z

Dm8tbr: Fix up download URL, as openSUSE mirrors are not reliable. Add footnote why clicking on repository URLs leads to 404.

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Add the repository ====
This expects that you have ''sudo'' installed, if not, open a root shell and run the ''echo'' command directly.

Copy paste the command for your distribution release and make sure that it's executed as '''one''' line!
{| class="wikitable"
!Distribution Release
!Command
!Repository<ref name="repository">openSUSE download mirrors are unreliable, so we point to their main download server. The downside is, that it has directory indexing disabled, so following the link using a web browser results in a HTTP 404. The repository URLs should work fine regardless as package managers don't rely on directory indexing, but directly access files instead.</ref>
!Comments
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Debian 6.0 (squeeze)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ repository]
|
|-
|Ubuntu 12.04 (precise)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|
|-
|Ubuntu 15.04 (vivid)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 15.10 (wily)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>!
|-
|Ubuntu 16.04 (xenial)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ repository]
|LTS<ref name="ubuntu-lts"/>
|-
|Ubuntu 16.10 (yakkety)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}

==== Import the ''Multimedia'' signing key ====
You need to add the openSUSE OBS [http://icecast.org/multimedia-obs.key '''Multimedia''' signing key] as a trusted key to your system.
There are many ways to verify they key, e.g. by a simple web search. After downloading the key, you can run this command: 
<code><nowiki>gpg multimedia-obs.key</nowiki></code> 
Should yield: 
<code><nowiki>pub 1024D/3A802234 2009-04-23 multimedia OBS Project <multimedia@build.opensuse.org></nowiki></code> 
Then you can import it: 
<code><nowiki>sudo apt-key add multimedia-obs.key</nowiki></code> 

The most simple, but not recommended way is: 
<code><nowiki>wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</nowiki></code> 

==== Update repository index ====
<code><nowiki>sudo apt-get update</nowiki></code>
==== Install Icecast ====
<code><nowiki>sudo apt-get install icecast2</nowiki></code>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository<ref name="repository"/>
!Comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 22
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/Fedora_22 repository]
|
|-
|Fedora 23
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/Fedora_23 repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository<ref name="repository"/>
!Comments
|-
|SUSE Linux Enterprise 11.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11.4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE 13.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.1 repository]
|
|-
|openSUSE 13.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.2 repository]
|
|-
|openSUSE Leap 42.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.1 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://downloadcontent.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

== Footnotes ==
<references/>
[[Category: Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2016-10-21T14:49:48Z

Dm8tbr: Added Ubuntu 16.10

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Add the repository ====
This expects that you have ''sudo'' installed, if not, open a root shell and run the ''echo'' command directly.

Copy paste the command for your distribution release and make sure that it's executed as '''one''' line!
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Debian 6.0 (squeeze)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ repository]
|
|-
|Ubuntu 12.04 (precise)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|
|-
|Ubuntu 15.04 (vivid)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 15.10 (wily)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>!
|-
|Ubuntu 16.04 (xenial)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.04/ repository]
|LTS<ref name="ubuntu-lts"/>
|-
|Ubuntu 16.10 (yakkety)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_16.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}

==== Import the ''Multimedia'' signing key ====
You need to add the openSUSE OBS [http://icecast.org/multimedia-obs.key '''Multimedia''' signing key] as a trusted key to your system.
There are many ways to verify they key, e.g. by a simple web search. After downloading the key, you can run this command: 
<code><nowiki>gpg multimedia-obs.key</nowiki></code> 
Should yield: 
<code><nowiki>pub 1024D/3A802234 2009-04-23 multimedia OBS Project <multimedia@build.opensuse.org></nowiki></code> 
Then you can import it: 
<code><nowiki>sudo apt-key add multimedia-obs.key</nowiki></code> 

The most simple, but not recommended way is: 
<code><nowiki>wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</nowiki></code> 

==== Update repository index ====
<code><nowiki>sudo apt-get update</nowiki></code>
==== Install Icecast ====
<code><nowiki>sudo apt-get install icecast2</nowiki></code>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 22
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_22 repository]
|
|-
|Fedora 23
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_23 repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|SUSE Linux Enterprise 11.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11.4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE 13.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.1 repository]
|
|-
|openSUSE 13.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.2 repository]
|
|-
|openSUSE Leap 42.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.1 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

== Footnotes ==
<references/>
[[Category: Icecast]]

XiphInfra:List of services

2016-10-10T21:53:35Z

Dm8tbr: update, westfish is pretty much gone, all hail mailfish!

{|class="wikitable sortable"
! Service
! URL
! VM
! Host
! Maintainer(s)
|-
| [[AreWeCompressedYet]]
| style="text-align:right;"| https://arewecompressedyet.com
| awcy
| style="text-align:right;"| https://catfish.xiph.org
| TD-Linux
|-
| Git Repos
| style="text-align:right;"| https://git.xiph.org
|
| style="text-align:right;"| https://mf4.xiph.org
| rillian
|-
| Home Pages
| style="text-align:right;"| https://people.xiph.org
|
| style="text-align:right;"| https://mf4.xiph.org
|
|-
| [[Icecast]] Streams
| style="text-align:right;"| http://dir.xiph.org
|
| style="text-align:right;"| http://dir.xiph.org
| tbr
|-
| [[Icecast]] Streams (Beta)
| style="text-align:right;"| http://dir-test.xiph.org
|
| style="text-align:right;"| http://mailfish.xiph.org
| ePirat, tbr
|-
| Jenkins
| style="text-align:right;"| https://mf4.xiph.org/jenkins/
| jenkins
| style="text-align:right;"| https://mf4.xiph.org
| TD-Linux
|-
| Mail
| style="text-align:right;"| xiph.org
|
| style="text-align:right;"| mailfish.xiph.org
| ePirat, tbr
|-
| MailMan
| style="text-align:right;"| http://lists.xiph.org
|
| style="text-align:right;"| mailfish.xiph.org
| ePirat, tbr
|-
| Media
| style="text-align:right;"| https://media.xiph.org
|
| style="text-align:right;"| https://media.xiph.org
|
|-
| Opus Boodler Streams
| style="text-align:right;"| https://opus-codec.org
|
| style="text-align:right;"| https://mf4.xiph.org
| gmaxwell
|-
| Rietveld
| style="text-align:right;"| https://review.xiph.org
| jenkins
| style="text-align:right;"| https://mf4.xiph.org
| unlord
|-
| Subversion Repos
| style="text-align:right;"| https://svn.xiph.org
|
| style="text-align:right;"| https://mf4.xiph.org
| rillian
|-
| Trac Bug Tracker
| style="text-align:right;"| https://trac.xiph.org
|
| style="text-align:right;"| https://mf4.xiph.org
| tbr
|-
| [[XiphWiki:Features|Wiki]]
| style="text-align:right;"| https://wiki.xiph.org
| [[XiphInfra:Wiki VM|wiki]]
| style="text-align:right;"| https://mf4.xiph.org
| ePirat
|-
| Xiph Mirror Repos
| style="text-align:right;"| https://github.com/xiph
|
|
| rillian
|-
| XiphBot-ng
| style="text-align:right;"| XiphWiki on freenode.net
|
| style="text-align:right;"| https://mf4.xiph.org
| TD-Linux
|}

<noinclude>See the [[XiphInfra:Overview|Overview]] page for more information.</noinclude>

Icecast Server/known reverse proxy restrictions

2016-08-11T12:29:41Z

Dm8tbr: Initial content

Icecast Server/known https restrictions

2016-08-11T12:24:09Z

Dm8tbr: Initial content

Icecast Server

2016-08-11T12:20:55Z

Dm8tbr: fix typo, remove question mark

[[File:Icecast_Logo.svg|100px|left]]
Icecast is a streaming media server which currently supports [[Ogg]] ([[Vorbis]] and [[Theora]]), [[Opus]] and WebM streams. 
MP3 works too, but it is not officially supported due to its non-free nature.

It can be used to create an Internet radio station or a privately-running jukebox and many things in between. 
It is very versatile in that new formats can be added relatively easily and supports open standards for communication and interaction.

Icecast is distributed under the GNU GPL, version 2.

== Icecast Articles ==

{{Special:PrefixIndex/Icecast Server/}}

== External Links ==

* [http://www.icecast.org/ Icecast homepage]
* [http://dir.xiph.org/index.php Stream directory]
* [http://dir.gmane.org/gmane.comp.audio.icecast.general Icecast mailing list archive] - You can search or browse Icecast user discussions here.
* [http://dir.gmane.org/gmane.comp.audio.icecast.devel Icecast developer mailing list archive] - You can search or browse Icecast discussions on icecast development here.
* [http://icecast.imux.net/index.php Inofficial Icecast forum]

== Development ==

You can find more information about the [[Icecast/Git_workflow|development workflow]] on a dedicated wiki page.

== Wish List ==

As good ideas are never a waste (and for tracking purposes) please list all the features you're missing in the icecast trunk as separate tickets on [https://trac.xiph.org/newticket?component=Icecast%20Server trac.xiph.org].

Note: please check that the feature you request is not already in trunk before posting!

[[Category:Icecast]]

__NOTOC__

Icecast Server/Installing latest version (official Xiph repositories)

2016-02-12T14:24:05Z

Dm8tbr: Add explicit footnote section

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Add the repository ====
This expects that you have ''sudo'' installed, if not, open a root shell and run the ''echo'' command directly.

Copy paste the command for your distribution release and make sure that it's executed as '''one''' line!
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Debian 6.0 (squeeze)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ repository]
|
|-
|Ubuntu 12.04 (precise)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|
|-
|Ubuntu 15.04 (vivid)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 15.10 (wily)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>!
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}

==== Import the ''Multimedia'' signing key ====
You need to add the openSUSE OBS [http://icecast.org/multimedia-obs.key '''Multimedia''' signing key] as a trusted key to your system.
There are many ways to verify they key, e.g. by a simple web search. After downloading the key, you can run this command: 
<code><nowiki>gpg multimedia-obs.key</nowiki></code> 
Should yield: 
<code><nowiki>pub 1024D/3A802234 2009-04-23 multimedia OBS Project <multimedia@build.opensuse.org></nowiki></code> 
Then you can import it: 
<code><nowiki>sudo apt-key add multimedia-obs.key</nowiki></code> 

The most simple, but not recommended way is: 
<code><nowiki>wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</nowiki></code> 

==== Update repository index ====
<code><nowiki>sudo apt-get update</nowiki></code>
==== Install Icecast ====
<code><nowiki>sudo apt-get install icecast2</nowiki></code>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 22
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_22 repository]
|
|-
|Fedora 23
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_23 repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|SUSE Linux Enterprise 11.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11.4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE 13.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.1 repository]
|
|-
|openSUSE 13.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.2 repository]
|
|-
|openSUSE Leap 42.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.1 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

== Footnotes ==
<references/>
[[Category: Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2016-02-12T14:21:04Z

Dm8tbr: whoops

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Add the repository ====
This expects that you have ''sudo'' installed, if not, open a root shell and run the ''echo'' command directly.

Copy paste the command for your distribution release and make sure that it's executed as '''one''' line!
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Debian 6.0 (squeeze)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ repository]
|
|-
|Ubuntu 12.04 (precise)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|
|-
|Ubuntu 15.04 (vivid)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 15.10 (wily)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ repository]
|''not'' LTS<ref name="ubuntu-lts"/>!
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}

==== Import the ''Multimedia'' signing key ====
You need to add the openSUSE OBS [http://icecast.org/multimedia-obs.key '''Multimedia''' signing key] as a trusted key to your system.
There are many ways to verify they key, e.g. by a simple web search. After downloading the key, you can run this command: 
<code><nowiki>gpg multimedia-obs.key</nowiki></code> 
Should yield: 
<code><nowiki>pub 1024D/3A802234 2009-04-23 multimedia OBS Project <multimedia@build.opensuse.org></nowiki></code> 
Then you can import it: 
<code><nowiki>sudo apt-key add multimedia-obs.key</nowiki></code> 

The most simple, but not recommended way is: 
<code><nowiki>wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</nowiki></code> 

==== Update repository index ====
<code><nowiki>sudo apt-get update</nowiki></code>
==== Install Icecast ====
<code><nowiki>sudo apt-get install icecast2</nowiki></code>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 22
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_22 repository]
|
|-
|Fedora 23
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_23 repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|SUSE Linux Enterprise 11.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11.4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE 13.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.1 repository]
|
|-
|openSUSE 13.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.2 repository]
|
|-
|openSUSE Leap 42.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.1 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

[[Category: Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2016-02-12T14:20:03Z

Dm8tbr: add footnotes clarifying "not LTS"

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Add the repository ====
This expects that you have ''sudo'' installed, if not, open a root shell and run the ''echo'' command directly.

Copy paste the command for your distribution release and make sure that it's executed as '''one''' line!
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Debian 6.0 (squeeze)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ repository]
|
|-
|Ubuntu 12.04 (precise)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|
|-
|Ubuntu 15.04 (vivid)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ repository]
|''not'' LTS<ref name="ubuntu-lts">Ubuntu releases that are not Long-Term-Support have a [https://wiki.ubuntu.com/Releases short life cycle]. Xiph.org will stop offering updated packages for those some time after Canonical/the Ubuntu Project end their support.</ref>!
|-
|Ubuntu 15.10 (wily)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ repository]
|''not'' LTS<ref name="ubuntu-lts">!
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}

==== Import the ''Multimedia'' signing key ====
You need to add the openSUSE OBS [http://icecast.org/multimedia-obs.key '''Multimedia''' signing key] as a trusted key to your system.
There are many ways to verify they key, e.g. by a simple web search. After downloading the key, you can run this command: 
<code><nowiki>gpg multimedia-obs.key</nowiki></code> 
Should yield: 
<code><nowiki>pub 1024D/3A802234 2009-04-23 multimedia OBS Project <multimedia@build.opensuse.org></nowiki></code> 
Then you can import it: 
<code><nowiki>sudo apt-key add multimedia-obs.key</nowiki></code> 

The most simple, but not recommended way is: 
<code><nowiki>wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</nowiki></code> 

==== Update repository index ====
<code><nowiki>sudo apt-get update</nowiki></code>
==== Install Icecast ====
<code><nowiki>sudo apt-get install icecast2</nowiki></code>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 22
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_22 repository]
|
|-
|Fedora 23
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_23 repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|SUSE Linux Enterprise 11.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11.4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE 13.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.1 repository]
|
|-
|openSUSE 13.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.2 repository]
|
|-
|openSUSE Leap 42.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.1 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

[[Category: Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2016-01-18T16:18:15Z

Dm8tbr: /* Debian and Ubuntu (in all its flavors) */ - Mint wants to be special snowflakes.

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Add the repository ====
This expects that you have ''sudo'' installed, if not, open a root shell and run the ''echo'' command directly.

Copy paste the command for your distribution release and make sure that it's executed as '''one''' line!
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Debian 6.0 (squeeze)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ repository]
|
|-
|Ubuntu 12.04 (precise)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|
|-
|Ubuntu 15.04 (vivid)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ repository]
|''not'' LTS!
|-
|Ubuntu 15.10 (wily)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ repository]
|''not'' LTS!
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
| actually available for ''all'' repository URLs
|-
|Linux Mint:
|Use the information listed above for the [https://en.wikipedia.org/wiki/List_of_Linux_Mint_releases#Release_history corresponding Ubuntu release].
|}
==== Import the ''Multimedia'' signing key ====
You need to add the openSUSE OBS [http://icecast.org/multimedia-obs.key '''Multimedia''' signing key] as a trusted key to your system.
There are many ways to verify they key, e.g. by a simple web search. After downloading the key, you can run this command: 
<code><nowiki>gpg multimedia-obs.key</nowiki></code> 
Should yield: 
<code><nowiki>pub 1024D/3A802234 2009-04-23 multimedia OBS Project <multimedia@build.opensuse.org></nowiki></code> 
Then you can import it: 
<code><nowiki>sudo apt-key add multimedia-obs.key</nowiki></code> 

The most simple, but not recommended way is: 
<code><nowiki>wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</nowiki></code> 

==== Update repository index ====
<code><nowiki>sudo apt-get update</nowiki></code>
==== Install Icecast ====
<code><nowiki>sudo apt-get install icecast2</nowiki></code>

== RedHat and its derivatives ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 22
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_22 repository]
|
|-
|Fedora 23
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_23 repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
!Distribution Release
!Command
!Repository
!Comments
|-
|SUSE Linux Enterprise 11.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11.4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE 13.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.1 repository]
|
|-
|openSUSE 13.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.2 repository]
|
|-
|openSUSE Leap 42.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.1 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

[[Category: Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2016-01-18T11:37:07Z

Dm8tbr: /* openSUSE */ - adding at least repository URLs

Xiph.org provides the latest version of Icecast packaged for [https://build.opensuse.org/package/repositories/multimedia:xiph/icecast various distributions]. The packages are built centrally from [https://build.opensuse.org/package/show/multimedia:xiph/icecast one set of sources] on the [https://build.opensuse.org/ openSUSE OpenBuildService instance] in the [https://build.opensuse.org/project/show/multimedia:xiph Multimedia/Xiph.org project].

Packages are usually available on release day. Packaging follows closely the original distro packaging to stay a seamless drop in replacement. The packages are meant for users who need the latest version of Icecast or HTTPS support, while their distribution doesn't provide it.

== Debian and Ubuntu (in all its flavors) ==
It takes 4 simple commands to install the latest Icecast version on a deb based distro.

==== Add the repository ====
This expects that you have ''sudo'' installed, if not, open a root shell and run the ''echo'' command directly.

Copy paste the command for your distribution release and make sure that it's executed as '''one''' line!
{| class="wikitable"
|Distribution Release
|command
|repository
|comments
|-
|Debian 8.0 (jessie)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
|
|-
|Debian 7.0 (wheezy)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_7.0/ repository]
|
|-
|Debian 6.0 (squeeze)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_6.0/ repository]
|
|-
|Ubuntu 12.04 (precise)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_12.04/ repository]
|
|-
|Ubuntu 14.04 (trusty)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_14.04/ repository]
|
|-
|Ubuntu 15.04 (vivid)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.04/ repository]
|''not'' LTS!
|-
|Ubuntu 15.10 (wily)
|<syntaxhighlight lang="bash">sudo sh -c "echo deb http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/xUbuntu_15.10/ repository]
|''not'' LTS!
|-
|source package, any deb distro
|<syntaxhighlight lang="bash">sudo sh -c "echo deb-src http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ ./ >>/etc/apt/sources.list.d/icecast.list"</syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Debian_8.0/ repository]
| actually available for ''all'' repository URLs
|}

==== Import the ''Multimedia'' signing key ====
You need to add the openSUSE OBS [http://icecast.org/multimedia-obs.key '''Multimedia''' signing key] as a trusted key to your system.
There are many ways to verify they key, e.g. by a simple web search. After downloading the key, you can run this command: 
<code><nowiki>gpg multimedia-obs.key</nowiki></code> 
Should yield: 
<code><nowiki>pub 1024D/3A802234 2009-04-23 multimedia OBS Project <multimedia@build.opensuse.org></nowiki></code> 
Then you can import it: 
<code><nowiki>sudo apt-key add multimedia-obs.key</nowiki></code> 

The most simple, but not recommended way is: 
<code><nowiki>wget -qO - http://icecast.org/multimedia-obs.key | sudo apt-key add -</nowiki></code> 

==== Update repository index ====
<code><nowiki>sudo apt-get update</nowiki></code>
==== Install Icecast ====
<code><nowiki>sudo apt-get install icecast2</nowiki></code>

== RedHat and its derivatives ==
{| class="wikitable"
|Distribution Release
|command
|repository
|comments
|-
|EPEL5 (RHEL 5/CentOS 5)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_5 repository]
|
|-
|EPEL6 (RHEL 6/CentOS 6)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_6 repository]
|
|-
|EPEL7 (RHEL 7/CentOS 7)
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/CentOS_7 repository]
|
|-
|Fedora 22
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_22 repository]
|
|-
|Fedora 23
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/Fedora_23 repository]
|
|-

|}

== openSUSE ==
{| class="wikitable"
|Distribution Release
|command
|repository
|comments
|-
|SUSE Linux Enterprise 11.3
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP3 repository]
|
|-
|SUSE Linux Enterprise 11.4
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_11_SP4 repository]
|
|-
|SUSE Linux Enterprise 12
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/SLE_12 repository]
|
|-
|openSUSE 13.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.1 repository]
|
|-
|openSUSE 13.2
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_13.2 repository]
|
|-
|openSUSE Leap 42.1
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Leap_42.1 repository]
|
|-
|openSUSE Tumbleweed
|<syntaxhighlight lang="bash"></syntaxhighlight>
|[http://download.opensuse.org/repositories/multimedia:/xiph/openSUSE_Tumbleweed repository]
|
|-

|}

[[Category: Icecast]]

Icecast Server/Installing latest version (official Xiph repositories)

2016-01-18T11:27:48Z

Dm8tbr: /* RedHat and its derivatives */ - add at least repository URLs

Icecast Server/Installing latest version (official Xiph repositories)

2015-11-05T09:24:49Z

Dm8tbr: Adding Ubuntu 15.10, removing EOL Ubuntu 14.10, also fixing the release names

Icecast Server/Installing latest version (official Xiph repositories)

2015-05-16T11:30:17Z

Dm8tbr: initial content, introduction, instructions for deb distros

Icecast Server/YP-protocol-v2

2015-03-15T10:15:44Z

Dm8tbr: added 'remove', some clean up, still needs variable types fixed

This page is to document and help collaborate on drafting and later finalizing a complete revision of the Icecast YP protocol and YP server behaviour.

== Overview ==

There continues to be a demand for listings of online radio stations. Especially player software likes to present the user with easy accessible station listings.

The Icecast stream directory at dir.xiph.org has been fulfilling those needs for years, along with some other directories. For players there is a machine readable XML export.

Over the years some deficiencies have become apparent. This revised protocol will try to address those, as well as aim to provide a structured specification to enable alternative implementations.

== Known deficiencies of the old protocol ==
* No defined way to send warnings to the submitting server, only failures
* No contact details in case directory operators need to reach a server administrator
* Multiple hacks in the POST request
* No good way to revise/extend the protocol without affecting backwards compatibility

== New to be introduced features ==
* Verification of stream availability through handshake

== Design goals for the new revision ==

== Old protocol - factual characteristics ==
This is based on current Icecast server code and the current php implementation of dir.xiph.org

=== Transport ===
The streaming server to directory communication happens over HTTP POST. Originally GET was used, but was deprecated 10 years ago and the directory stopped supporting it later on.

<code>POST /cgi-bin/yp-cgi HTTP/1.1 
User-Agent: Icecast 2.4.1 
Host: dir.xiph.org 
Accept: */* 
Content-Length: 133 
Content-Type: application/x-www-form-urlencoded</code>

The directory request is contained in the message body as urlencoded data.

=== Request types ===

There are 3 defined request types:

* Add
* Touch
* Remove

==== Add ====
This type of request will add a new server entry to the directory.

The request MUST have the following parameters :

{| class="wikitable"
|-
!parameter !! value !! explanation
|-
|action || '''add''' || They YP protocol request type
|-
|sn || string || The name of the stream
|-
|type || string || content type
|-
|genre || string || genre, space delimited(?)
|-
|b || string(!?) || The expected average bitrate for the stream
|-
|listenurl || URL || the URL of the actual stream, as used by player clients
|}

The URL call will have the following *optional* parameters :
{| class="wikitable"
|-
!parameter !! value !! explanation
|-
|cpswd ||string||Cluster Password (broadcasts with the same Server Name and cluster password will be displayed together in the directory server).
|-
|user ||string||''never implemented'' YP userid
|-
|pass ||string||''never implemented'' YP password
|-
|desc ||string||Server Description
|-
|url ||url||Stream URL (not the listen url, usually a link to the broadcasters website)
|-
|stype ||string||Server Sub type. Used normally for multi-codec streams (ogg/theora, vp6/aac). Codecs should be separated by a '/' delimiter.''verify''
|}

The listing scripts will respond with the following HTTP headers
{| class="wikitable"
|-
!header !! value !! explanation
|-
|YPResponse: ||0;1||0-failure or 1-success
|-
|YPMessage: ||string||Any error message
|-
|SID: ||string||System Identifier which represents the unique identifier for the new listing entry. All futher communications must be made using this SID - the SID can be any alpha numeric string
|-
||TouchFreq: ||The frequency (in seconds) in which the listing client needs to touch the server in order to prevent a stale record
|}

==== touch ====

This type of request will update a server entry with new information. This request will also cause the listing server to acknowledge this server as one that is still valid. Periodic cleanups of inactive servers will be performed on the listing server.

The URL call will have the following mandatory parameters :

{| class="wikitable"
|-
!parameter !! value !! explanation
|-
|action || '''remove''' || They YP protocol request type
|-
|sid || string || session ID
|}

The URL call will have the following *optional* parameters :
{| class="wikitable"
|-
!parameter !! value !! explanation
|-
|st ||string||Song title
|-
|listeners||string||Current number of listeners
|-
|max_listeners||string||max listener limit for this stream
|-
|alt||string||average listening time [not implemented]
|-
|ht||string||hits / tune ins
|-
|cm||string||5min average tune ins
|-
|stype||string||Server Sub type. Used normally for multi-codec streams (ogg/theora, vp6/aac). Codecs should be separated by a '/' delimiter. - Note that since it is possible to change codecs mid stream in some container formats, so this field is updatable on a touch.
|}
The listing scripts will respond with the following HTTP headers
{| class="wikitable"
|-
!header !! value !! explanation
|-
|YPResponse: ||0;1||0-failure or 1-success
|-
|YPMessage: ||string||Any error message
|}
==== remove ====

This type of request will remove a server entry.
This request should be done when either the broadcast has stopped, or the icecast2 server is shutting down.

The URL call will have the following mandatory parameters :

{| class="wikitable"
|-
!parameter !! value !! explanation
|-
|action || '''remove''' || They YP protocol request type
|-
|sid || string || session ID
|}

The URL call does NOT have *optional* parameters!

The listing scripts will respond with the following HTTP headers
{| class="wikitable"
|-
!header !! value !! explanation
|-
|YPResponse: ||0;1||0-failure or 1-success
|-
|YPMessage: ||string||Any error message
|}

Icecast Server/YP-protocol-v2

2015-03-08T20:09:00Z

Dm8tbr: some content, mainly based on very old spec

This page is to document and help collaborate on drafting and later finalizing a complete revision of the Icecast YP protocol and YP server behaviour.

== Overview ==

There continues to be a demand for listings of online radio stations. Especially player software likes to present the user with easy accessible station listings.

The Icecast stream directory at dir.xiph.org has been fulfilling those needs for years, along with some other directories. For players there is a machine readable XML export.

Over the years some deficiencies have become apparent. This revised protocol will try to address those, as well as aim to provide a structured specification to enable alternative implementations.

== Known deficiencies of the old protocol ==
* No defined way to send warnings to the submitting server, only failures
* No contact details in case directory operators need to reach a server administrator
* Multiple hacks in the POST request
* No good way to revise/extend the protocol without affecting backwards compatibility

== New to be introduced features ==
* Verification of stream availability through handshake

== Design goals for the new revision ==

== Old protocol - factual characteristics ==
This is based on current Icecast server code and the current php implementation of dir.xiph.org

=== Transport ===
The streaming server to directory communication happens over HTTP POST. Originally GET was used, but was deprecated 10 years ago and the directory stopped supporting it later on.

<code>POST /cgi-bin/yp-cgi HTTP/1.1 
User-Agent: Icecast 2.4.1 
Host: dir.xiph.org 
Accept: */* 
Content-Length: 133 
Content-Type: application/x-www-form-urlencoded</code>

The directory request is contained in the message body as urlencoded data.

=== Request types ===

There are 3 defined request types:

* Add
* Touch
* Remove

==== Add ====
This type of request will add a new server entry to the directory.

The request MUST have the following parameters :

{| class="wikitable"
|-
!parameter !! value !! explanation
|-
|action || '''add''' || They YP protocol request type
|-
|sn || string || The name of the stream
|-
|type || string || content type
|-
|genre || string || genre, space delimited(?)
|-
|b || string(!?) || The expected average bitrate for the stream
|-
|listenurl || URL || the URL of the actual stream, as used by player clients
|}

The URL call will have the following *optional* parameters :
{| class="wikitable"
|-
!parameter !! value !! explanation
|-
|cpswd ||string||Cluster Password (broadcasts with the same Server Name and cluster password will be displayed together in the directory server).
|-
|user ||string||''never implemented'' YP userid
|-
|pass ||string||''never implemented'' YP password
|-
|desc ||string||Server Description
|-
|url ||url||Stream URL (not the listen url, usually a link to the broadcasters website)
|-
|stype ||string||Server Sub type. Used normally for multi-codec streams (ogg/theora, vp6/aac). Codecs should be separated by a '/' delimiter.''verify''
|}

The listing scripts will respond with the following HTTP headers
{| class="wikitable"
|-
!header !! value !! explanation
|-
|YPResponse: ||0;1||0-failure or 1-success
|-
|YPMessage: ||string||Any error message
|-
|SID: ||string||System Identifier which represents the unique identifier for the new listing entry. All futher communications must be made using this SID - the SID can be any alpha numeric string
|-
||TouchFreq: ||The frequency (in seconds) in which the listing client needs to touch the server in order to prevent a stale record
|}

==== touch ====

This type of request will update a server entry with new information. This request will also cause the listing server to acknowledge this server as one that is still valid. Periodic cleanups of inactive servers will be performed on the listing server.

The URL call will have the following mandatory parameters :

{| class="wikitable"
|-
!parameter !! value !! explanation
|-
|action || '''add''' || They YP protocol request type
|-
|sid || string || session ID
|}

The URL call will have the following *optional* parameters :
{| class="wikitable"
|-
!parameter !! value !! explanation
|-
|st ||string||Song title
|-
|listeners||string||Current number of listeners
|-
|max_listeners||string||max listener limit for this stream
|-
|alt||string||average listening time [not implemented]
|-
|ht||string||hits / tune ins
|-
|cm||string||5min average tune ins
|-
|stype||string||Server Sub type. Used normally for multi-codec streams (ogg/theora, vp6/aac). Codecs should be separated by a '/' delimiter. - Note that since it is possible to change codecs mid stream in some container formats, so this field is updatable on a touch.
|}
The listing scripts will respond with the following HTTP headers
{| class="wikitable"
|-
!header !! value !! explanation
|-
|YPResponse: ||0;1||0-failure or 1-success
|-
|YPMessage: ||string||Any error message
|-
|TouchFreq: || ||''verify if this is honored, wasn't in old spec'' The frequency (in seconds) in which the listing client needs to touch the server in order to prevent a stale record
|}

Summer of Code Applications

2015-03-03T09:12:08Z

Dm8tbr: adjustments for 2015

== Applying for a Google Summer of Code project with Xiph.Org ==

Prospective students: please fill out a copy of this template for your application, answering each question in plenty of detail. The more information the better - though we might ask you later for more details anyway. You can fill in your application at http://www.google-melange.com/gsoc/homepage/google/gsoc2015

Our list of suggested projects is at [[Summer_of_Code_2015]]. You're welcome to suggest other projects, though, if you think you have a good idea. Feel free to jump on IRC (irc.freenode.net, #icecast) if you'd like to discuss things before submitting a project proposal.

To be accepted, you '''must''' join the project at least peripherally ahead of time. Checking out the code, compiling and submitting sample code are highly recommended bug fixes even better :) Join the [http://lists.xiph.org/mailman/listinfo/icecast-dev Icecast developer mailing list] and introduce yourself. Hang out with us on IRC. Give us a chance to get to know you. Don't be shy. Multimedia programming is technically demanding and while we do everything we can to help our students, we need to understand what your background is, what you know and what we'll need to work on before we can properly evaluate your application.

To reiterate: '''The absolute best thing you can do is to pick a small project or bug and contribute some code. That will give you and us an idea what it's like to work together.'''

We also recommend students to read the [http://en.flossmanuals.net/GSoCStudentGuide/ student guide book], it has valuable information and tips.

== '''Contact Detail''' ==
What is your name and If you are regular user of Freenode IRC then Provide your Nick name.

= Your background =

You're a student! Tell us about what you're studying, where, and so on. Tell us what your interests are, what (if any) work you've previously done in the field of multimedia, and so on.

If you've worked on free software before, that's great. Tell us what you've worked on, what you've done for those projects, etc.

= Project =

What project would you like to work on? If it's one from our list of suggestions, don't just copy the title from there - tell us a bit about what approach(es) you'd like to take to this project. If it's not from that list, tell us as much as you can about what you want to do.

= Project outcomes =

Go into more details here: what do you think you'll be able to get done in the three months available? Name specific goals: features, percentage performance improvements, etc.

= Schedule =

Give us a rough outline of how you want to schedule your work over the three months. If you're going to be away for any part of that, let us know now - it's not a problem if you're heading off on holidays for a week or two, but we have to be convinced you're going to put enough time in. When will you start? What milestones do you want within the project? How much time will you be able to put in? Is this the only thing you'll be doing during the term or do you have other commitments?

= Why should we select you? =

Google's Summer of Code project is enormously popular - unfortunately, we'll have to reject many more proposals than we'll be able to accept. So this is your chance to tell us what makes YOU the best person for us to pick.

Summer of Code 2015

2015-02-25T11:02:23Z

Dm8tbr: added webm improvement task

This is our ideas page for [http://www.google-melange.com/gsoc/document/show/gsoc_program/google/gsoc2015 Google Summer of Code 2015] projects with [http://xiph.org Xiph.org].

'''Students''' please use the template at [[Summer of Code Applications]] when applying for a GSoC position.

'''Mentors''' please visit [[Summer of Code Mentoring]] and help us prepare our application as a mentoring organization.

== Introduction ==

This year Xiph.org is focusing on the Icecast streaming multimedia server for its GSoC participation. Both audio and video live streaming are currently hot topics, especially due to improved HTML5 support for this technology.

Below you'll find the description for the following GSoC project ideas around the Icecast project.
* Configuration interface
* Let's encrypt for Icecast
* Improved WebM support for Icecast
* Stream directory API
* Client side for stream directory API
* DoS mitigation

If you want to know more about a particular idea, please get in touch with the people listed under "possible mentors". While no guarantee, that the person will be the actual mentor for the task, they know it and will be happy to answer your questions.

In addition Trac contains some [https://trac.xiph.org/query?status=assigned&status=new&status=reopened&keywords=~gsoc&col=id&col=summary&col=status&col=type&col=milestone&col=component&order=priority tickets tagged GSoC] that can serve as starting points for developing project ideas.

In our previous participation we focused a lot on our multimedia codec projects. This turned out to be very challenging for students. So this year we're not offering project ideas from those. If you're a student interested in codec work, have previous experience in it and are confident, that you can convince us, you're welcome to get in touch.
----

== Detailed Project Descriptions ==

These ideas were suggested by various members of the developer community as projects that would be beneficial and which we feel we can mentor. Students should feel free to select one of these, develop a variation, or propose their own ideas. Here, ideally.

----

=== Icecast configuration interface ===

Icecast is very flexible in its configuration and uses XML to store configuration.

==== Problem / Intro ====

While we do our best to document things and have a solid default configuration, many users fail at setting up Icecast by e.g. malforming the XML or misunderstanding options.

==== Solution / Task ====

The Icecast project should have its own reference configuration UI. It should expose all possible configuration options. It should have several detail levels to make it easier for users. ''Easy'' with only core items, up to ''Expert'' exposing all items. Either from scratch or by adopting existing open source code.

[https://trac.xiph.org/ticket/2127 ticket on this topic]

==== Requirements ====

The student should be familiar with XML, c programming and HTML. 
The task, although seemingly easy is considered hard and high workload, also it requires cross-domain knowledge to work on front and back end.

==== Possible Mentors ====

Thomas B. Rücker, tbr
----

=== ''Let's encrypt'' for Icecast ===

Icecast supports HTTPS through openSSL. The [https://letsencrypt.org/ Let's encrypt] project will offer automated and free certificates.

==== Problem / Intro ====

Configuring Icecast is challenging, doing it for SSL adds a layer of complexity. Problems like correct hostname configuration, certificate preparation become an additional deployment burden.

==== Solution / Task ====

Integrate with or create a derivative of the [https://github.com/letsencrypt/lets-encrypt-preview ''Let's encrypt'' agent]. Take into account specific challenges, such as determining the correct and intended DNS name (hostname) of the Icecast server.

==== Requirements ====

The student should be familiar with Python. Familiar with and running Ubuntu (native or in a virtual machine), due to upstream development target. 
It is considered a medium difficulty task, as it is mostly about one aspect and with a well developed API on the other side.

==== Possible Mentors ====

Thomas B. Rücker, tbr
----

=== Improved WebM support in Icecast ===

Icecast supports WebM live streams since version 2.4.0 enabling many interesting HTML5 use cases.

==== Problem / Intro ====

While WebM support is solid, it is rather limited. For Theora streams we extract information from the stream about resolution and other parameters.

==== Solution / Task ====

* Dive into the EBML/Matroska/WebM format, reliably extract the necessary data, make it available as part of the Icecast metadata structure.
* Investigate and implement ways to splice WebM streams reliably to enable transitions between streams that have sufficiently close/identical parameters.
* Verify support of VP9/Opus in WebM
* Verify and improve support of audio only WebM

Further information can be found by looking at the tracker tickets and it's dependencies: 
https://trac.xiph.org/ticket/2155
==== Requirements ====

The student must know C and either have previous EBML experience or demonstrate the ability to learn it ''before'' being approved. This is due to the high risk of failure we see otherwise. 
It is considered a very difficult task, as it touches on container formats and codec parameters.

==== Possible Mentors ====

Thomas B. Rücker, tbr
nn

----
=== Stream directory API ===

For live streams Xiph.org operates a directory, mainly used by Icecast. It lists tens of thousands of streams.

==== Problem / Intro ====

The old directory only exposes a XML export of most of the database as the closest thing to an API. A lot of listener software uses this XML, but would benefit from a server side search. We've been experimenting with exposing a feature rich JSON API, but then decided to rewrite the directory code from scratch.

==== Solution / Task ====

The rewritten directory needs a well designed API with a performance optimized and robust implementation that integrates with listener software, it has been set up in a way that will make this sufficiently easy. The API will need to be tested.

==== Requirements ====

The student should be familiar with nodejs, SQL (in particular Postgres) and JSON (both generating and consuming). 
API design knowledge would be appreciated, but we have that also in the core team. 
This task can be fairly easy, but depending on the student's capabilities can be scaled to medium.

==== Possible Mentors ====

Thomas B. Rücker, tbr 
Marvin Scholz, ePirat
----

=== Client side for stream directory API ===

For live streams Xiph.org operates a directory, mainly used by Icecast. It lists tens of thousands of streams.

==== Problem / Intro ====

The old directory only exposes a XML export of most of the database as the closest thing to an API. A lot of listener software uses this XML, but would benefit from a server side search. We've been experimenting with exposing a feature rich JSON API, but then decided to rewrite the directory code from scratch. We are designing and implementing a JSON API (possibly also as part of GSoC), but will need client software to use it.

==== Solution / Task ====

To start the student will need to find as many open source consumers of the old XML API as possible and also open source players that don't have Icecast directory support yet, but would benefit from it. Then after agreeing with us on a short list of software, depending on the students knowledge of programming language used and client software popularity, implement new directory support for those players (at least one, possibly more if time and complexity allow).

==== Requirements ====

The student should be familiar with JSON, the HTTP protocol and at least one major programing language (preferably C; if other show, that there are possible target projects written in that language). 
Difficulty of this task will depend on the chosen player project, but we're expecting it to be in the medium to even hard range.

==== Possible Mentors ====

Thomas B. Rücker, tbr
----

=== Investigate URL-Auth (D)DoS Mitigation Possibilities ===

Icecast is very flexible in its configuration and allows authentication to be delegated to a backend server. This server has to accept and answer connections in a fast and reliable manner.

==== Problem / Intro ====

While we do our best to test things and do quite a bit to harden the mentioned process there are certain risks to be evaluated in regard of:
# Server load - Icecast and Backend Server
# Timeouts - What happens when the Backend does not answer inside the timout window?
# Responsiveness - What happens if a Icecast server has to wait on many Backend requests to finish?
# (if implemented by then) TLS Client Cert Auth - TLS Client Auth gives us quite some more possibilities for URL-Auth

==== Solution / Task ====

To start the student should familiarize themselves with the URL-Auth system and then investigate the above problems.
Patches for identified issues and improvements for optimizing and enhancing the default behaviour should be the primary output.
As a side effect it should result in best practices for configuring url-auth reliably.

==== Requirements ====

The student should be familiar with the HTTP protocol (versions 1.0 and 1.1), the C programming language and also with stress-testing. 
The task also requires imagination and the ability to develop own innovative approaches to testing certain aspects. It is not suitable for students who require a lot of exact steps and guidance. Workload can be scaled in agreement with the mentor, by leaving out certain aspects.

==== Possible Mentors ====
stephanj 
Thomas B. Rücker, tbr

==See Also==
*[[Summer of Code 2009]]
*[[Summer of Code 2008]]
*[[Summer of Code 2007]]
*[[Summer of Code 2006]]

Summer of Code 2015

2015-02-22T14:39:29Z

Dm8tbr: /* Introduction */

This is our ideas page for [http://www.google-melange.com/gsoc/document/show/gsoc_program/google/gsoc2015 Google Summer of Code 2015] projects with [http://xiph.org Xiph.org].

'''Students''' please use the template at [[Summer of Code Applications]] when applying for a GSoC position.

'''Mentors''' please visit [[Summer of Code Mentoring]] and help us prepare our application as a mentoring organization.

== Introduction ==

This year Xiph.org is focusing on the Icecast streaming multimedia server for its GSoC participation. Both audio and video live streaming are currently hot topics, especially due to improved HTML5 support for this technology.

Below you'll find the description for the following GSoC project ideas around the Icecast project.
* Configuration interface
* Let's encrypt for Icecast
* Stream directory API
* Client side for stream directory API
* DoS mitigation

If you want to know more about a particular idea, please get in touch with the people listed under "possible mentors". While no guarantee, that the person will be the actual mentor for the task, they know it and will be happy to answer your questions.

In addition Trac contains some [https://trac.xiph.org/query?status=assigned&status=new&status=reopened&keywords=~gsoc&col=id&col=summary&col=status&col=type&col=milestone&col=component&order=priority tickets tagged GSoC] that can serve as starting points for developing project ideas.

In our previous participation we focused a lot on our multimedia codec projects. This turned out to be very challenging for students. So this year we're not offering project ideas from those. If you're a student interested in codec work, have previous experience in it and are confident, that you can convince us, you're welcome to get in touch.
----

== Detailed Project Descriptions ==

These ideas were suggested by various members of the developer community as projects that would be beneficial and which we feel we can mentor. Students should feel free to select one of these, develop a variation, or propose their own ideas. Here, ideally.

----

=== Icecast configuration interface ===

Icecast is very flexible in its configuration and uses XML to store configuration.

==== Problem / Intro ====

While we do our best to document things and have a solid default configuration, many users fail at setting up Icecast by e.g. malforming the XML or misunderstanding options.

==== Solution / Task ====

The Icecast project should have its own reference configuration UI. It should expose all possible configuration options. It should have several detail levels to make it easier for users. ''Easy'' with only core items, up to ''Expert'' exposing all items. Either from scratch or by adopting existing open source code.

[https://trac.xiph.org/ticket/2127 ticket on this topic]

==== Requirements ====

The student should be familiar with XML, c programming and HTML. 
The task, although seemingly easy is considered hard and high workload, also it requires cross-domain knowledge to work on front and back end.

==== Possible Mentors ====

Thomas B. Rücker, tbr
----

=== ''Let's encrypt'' for Icecast ===

Icecast supports HTTPS through openSSL. The [https://letsencrypt.org/ Let's encrypt] project will offer automated and free certificates.

==== Problem / Intro ====

Configuring Icecast is challenging, doing it for SSL adds a layer of complexity. Problems like correct hostname configuration, certificate preparation become an additional deployment burden.

==== Solution / Task ====

Integrate with or create a derivative of the [https://github.com/letsencrypt/lets-encrypt-preview ''Let's encrypt'' agent]. Take into account specific challenges, such as determining the correct and intended DNS name (hostname) of the Icecast server.

==== Requirements ====

The student should be familiar with Python. Familiar with and running Ubuntu (native or in a virtual machine), due to upstream development target. 
It is considered a medium difficulty task, as it is mostly about one aspect and with a well developed API on the other side.

==== Possible Mentors ====

Thomas B. Rücker, tbr
----

=== Stream directory API ===

For live streams Xiph.org operates a directory, mainly used by Icecast. It lists tens of thousands of streams.

==== Problem / Intro ====

The old directory only exposes a XML export of most of the database as the closest thing to an API. A lot of listener software uses this XML, but would benefit from a server side search. We've been experimenting with exposing a feature rich JSON API, but then decided to rewrite the directory code from scratch.

==== Solution / Task ====

The rewritten directory needs a well designed API with a performance optimized and robust implementation that integrates with listener software, it has been set up in a way that will make this sufficiently easy. The API will need to be tested.

==== Requirements ====

The student should be familiar with nodejs, SQL (in particular Postgres) and JSON (both generating and consuming). 
API design knowledge would be appreciated, but we have that also in the core team. 
This task can be fairly easy, but depending on the student's capabilities can be scaled to medium.

==== Possible Mentors ====

Thomas B. Rücker, tbr 
Marvin Scholz, ePirat
----

=== Client side for stream directory API ===

For live streams Xiph.org operates a directory, mainly used by Icecast. It lists tens of thousands of streams.

==== Problem / Intro ====

The old directory only exposes a XML export of most of the database as the closest thing to an API. A lot of listener software uses this XML, but would benefit from a server side search. We've been experimenting with exposing a feature rich JSON API, but then decided to rewrite the directory code from scratch. We are designing and implementing a JSON API (possibly also as part of GSoC), but will need client software to use it.

==== Solution / Task ====

To start the student will need to find as many open source consumers of the old XML API as possible and also open source players that don't have Icecast directory support yet, but would benefit from it. Then after agreeing with us on a short list of software, depending on the students knowledge of programming language used and client software popularity, implement new directory support for those players (at least one, possibly more if time and complexity allow).

==== Requirements ====

The student should be familiar with JSON, the HTTP protocol and at least one major programing language (preferably C; if other show, that there are possible target projects written in that language). 
Difficulty of this task will depend on the chosen player project, but we're expecting it to be in the medium to even hard range.

==== Possible Mentors ====

Thomas B. Rücker, tbr
----

=== Investigate URL-Auth (D)DoS Mitigation Possibilities ===

Icecast is very flexible in its configuration and allows authentication to be delegated to a backend server. This server has to accept and answer connections in a fast and reliable manner.

==== Problem / Intro ====

While we do our best to test things and do quite a bit to harden the mentioned process there are certain risks to be evaluated in regard of:
# Server load - Icecast and Backend Server
# Timeouts - What happens when the Backend does not answer inside the timout window?
# Responsiveness - What happens if a Icecast server has to wait on many Backend requests to finish?
# (if implemented by then) TLS Client Cert Auth - TLS Client Auth gives us quite some more possibilities for URL-Auth

==== Solution / Task ====

To start the student should familiarize themselves with the URL-Auth system and then investigate the above problems.
Patches for identified issues and improvements for optimizing and enhancing the default behaviour should be the primary output.
As a side effect it should result in best practices for configuring url-auth reliably.

==== Requirements ====

The student should be familiar with the HTTP protocol (versions 1.0 and 1.1), the C programming language and also with stress-testing. 
The task also requires imagination and the ability to develop own innovative approaches to testing certain aspects. It is not suitable for students who require a lot of exact steps and guidance. Workload can be scaled in agreement with the mentor, by leaving out certain aspects.

==== Possible Mentors ====
stephanj 
Thomas B. Rücker, tbr

==See Also==
*[[Summer of Code 2009]]
*[[Summer of Code 2008]]
*[[Summer of Code 2007]]
*[[Summer of Code 2006]]

Summer of Code 2015

2015-02-22T14:28:30Z

Dm8tbr: pretty things up, more readable

This is our ideas page for [http://www.google-melange.com/gsoc/document/show/gsoc_program/google/gsoc2015 Google Summer of Code 2015] projects with [http://xiph.org Xiph.org].

'''Students''' please use the template at [[Summer of Code Applications]] when applying for a GSoC position.

'''Mentors''' please visit [[Summer of Code Mentoring]] and help us prepare our application as a mentoring organization.

== Introduction ==

This year Xiph.org is focusing on the Icecast streaming multimedia server for its GSoC participation. Both audio and video live streaming are currently hot topics, especially due to improved HTML5 support for this technology.

Below you'll find the description for the following GSoC project ideas around the Icecast project.
* Configuration interface
* Let's encrypt for Icecast
* Improved video stream handling
* Improved stream meta-data handling
* Stream directory API
* Client side for stream directory API

If you want to know more about a particular idea, please get in touch with the people listed under "possible mentors". While no guarantee, that the person will be the actual mentor for the task, they know it and will be happy to answer your questions.

In addition Trac contains some [https://trac.xiph.org/query?status=assigned&status=new&status=reopened&keywords=~gsoc&col=id&col=summary&col=status&col=type&col=milestone&col=component&order=priority tickets tagged GSoC] that can serve as starting points for developing project ideas.

In our previous participation we focused a lot on our multimedia codec projects. This turned out to be very challenging for students. So this year we're not offering project ideas from those. If you're a student interested in codec work, have previous experience in it and are confident, that you can convince us, you're welcome to get in touch.

----

== Detailed Project Descriptions ==

These ideas were suggested by various members of the developer community as projects that would be beneficial and which we feel we can mentor. Students should feel free to select one of these, develop a variation, or propose their own ideas. Here, ideally.

----

=== Icecast configuration interface ===

Icecast is very flexible in its configuration and uses XML to store configuration.

==== Problem / Intro ====

While we do our best to document things and have a solid default configuration, many users fail at setting up Icecast by e.g. malforming the XML or misunderstanding options.

==== Solution / Task ====

The Icecast project should have its own reference configuration UI. It should expose all possible configuration options. It should have several detail levels to make it easier for users. ''Easy'' with only core items, up to ''Expert'' exposing all items. Either from scratch or by adopting existing open source code.

[https://trac.xiph.org/ticket/2127 ticket on this topic]

==== Requirements ====

The student should be familiar with XML, c programming and HTML. 
The task, although seemingly easy is considered hard and high workload, also it requires cross-domain knowledge to work on front and back end.

==== Possible Mentors ====

Thomas B. Rücker, tbr
----

=== ''Let's encrypt'' for Icecast ===

Icecast supports HTTPS through openSSL. The [https://letsencrypt.org/ Let's encrypt] project will offer automated and free certificates.

==== Problem / Intro ====

Configuring Icecast is challenging, doing it for SSL adds a layer of complexity. Problems like correct hostname configuration, certificate preparation become an additional deployment burden.

==== Solution / Task ====

Integrate with or create a derivative of the [https://github.com/letsencrypt/lets-encrypt-preview ''Let's encrypt'' agent]. Take into account specific challenges, such as determining the correct and intended DNS name (hostname) of the Icecast server.

==== Requirements ====

The student should be familiar with Python. Familiar with and running Ubuntu (native or in a virtual machine), due to upstream development target. 
It is considered a medium difficulty task, as it is mostly about one aspect and with a well developed API on the other side.

==== Possible Mentors ====

Thomas B. Rücker, tbr
----

=== Stream directory API ===

For live streams Xiph.org operates a directory, mainly used by Icecast. It lists tens of thousands of streams.

==== Problem / Intro ====

The old directory only exposes a XML export of most of the database as the closest thing to an API. A lot of listener software uses this XML, but would benefit from a server side search. We've been experimenting with exposing a feature rich JSON API, but then decided to rewrite the directory code from scratch.

==== Solution / Task ====

The rewritten directory needs a well designed API with a performance optimized and robust implementation that integrates with listener software, it has been set up in a way that will make this sufficiently easy. The API will need to be tested.

==== Requirements ====

The student should be familiar with nodejs, SQL (in particular Postgres) and JSON (both generating and consuming). 
API design knowledge would be appreciated, but we have that also in the core team. 
This task can be fairly easy, but depending on the student's capabilities can be scaled to medium.

==== Possible Mentors ====

Thomas B. Rücker, tbr 
Marvin Scholz, ePirat
----

=== Client side for stream directory API ===

For live streams Xiph.org operates a directory, mainly used by Icecast. It lists tens of thousands of streams.

==== Problem / Intro ====

The old directory only exposes a XML export of most of the database as the closest thing to an API. A lot of listener software uses this XML, but would benefit from a server side search. We've been experimenting with exposing a feature rich JSON API, but then decided to rewrite the directory code from scratch. We are designing and implementing a JSON API (possibly also as part of GSoC), but will need client software to use it.

==== Solution / Task ====

To start the student will need to find as many open source consumers of the old XML API as possible and also open source players that don't have Icecast directory support yet, but would benefit from it. Then after agreeing with us on a short list of software, depending on the students knowledge of programming language used and client software popularity, implement new directory support for those players (at least one, possibly more if time and complexity allow).

==== Requirements ====

The student should be familiar with JSON, the HTTP protocol and at least one major programing language (preferably C; if other show, that there are possible target projects written in that language). 
Difficulty of this task will depend on the chosen player project, but we're expecting it to be in the medium to even hard range.

==== Possible Mentors ====

Thomas B. Rücker, tbr
----

=== Investigate URL-Auth (D)DoS Mitigation Possibilities ===

Icecast is very flexible in its configuration and allows authentication to be delegated to a backend server. This server has to accept and answer connections in a fast and reliable manner.

==== Problem / Intro ====

While we do our best to test things and do quite a bit to harden the mentioned process there are certain risks to be evaluated in regard of:
# Server load - Icecast and Backend Server
# Timeouts - What happens when the Backend does not answer inside the timout window?
# Responsiveness - What happens if a Icecast server has to wait on many Backend requests to finish?
# (if implemented by then) TLS Client Cert Auth - TLS Client Auth gives us quite some more possibilities for URL-Auth

==== Solution / Task ====

To start the student should familiarize themselves with the URL-Auth system and then investigate the above problems.
Patches for identified issues and improvements for optimizing and enhancing the default behaviour should be the primary output.
As a side effect it should result in best practices for configuring url-auth reliably.

==== Requirements ====

The student should be familiar with the HTTP protocol (versions 1.0 and 1.1), the C programming language and also with stress-testing. 
The task also requires imagination and the ability to develop own innovative approaches to testing certain aspects. It is not suitable for students who require a lot of exact steps and guidance. Workload can be scaled in agreement with the mentor, by leaving out certain aspects.

==== Possible Mentors ====
stephanj 
Thomas B. Rücker, tbr

==See Also==
*[[Summer of Code 2009]]
*[[Summer of Code 2008]]
*[[Summer of Code 2007]]
*[[Summer of Code 2006]]

Summer of Code Mentoring

2015-02-19T17:52:29Z

Dm8tbr: edited to cover 2008/2009 which apparently didn't go well.

== Xiph.Org Application as a mentoring organization ==

We need to apply for consideration as a mentoring organization 2015 February 9 - 20. Google lists the following questions in their [http://www.google-melange.com/gsoc/document/show/gsoc_program/google/gsoc2015/help_page#1._How_does_a_mentoring_organization faq]. Our work-in-progress answers are inline.

==== Describe your organization. ====

The Xiph.Org Foundation is a 501(c)(3) non-profit organization dedicated to providing open and free-to-implement multimedia technology as a foundation for an interoperable, level playing field on the Internet and other digital distribution networks. Over the past 14 years we have developed most of the major patent-free and royalty-free audio and video codecs currently in use, including Opus, Vorbis, Speex, FLAC and Theora, as well as developing the Ogg streaming format, and the Icecast streaming media server. Xiph hosted libraries like liboggplay and liboggz power the underling html5 video support in Mozilla Firefox.

==== Why is your organization applying to participate in Google Summer of Code 2015? What do you hope to gain by participating? ====

We believe that the Xiph.Org Foundation and specifically the Icecast Project has a wide-ranging set of projects that are both challenging and educational for students. Furthermore, they are important/useful goals for the wider technology community, and especially users of open source software.

We believe that Xiph's mandate to develop multimedia standards and software is an important one, but as a small non-profit with no official staff we—of course—have limited resources. We hope that the results of GSoC will include the direct benefit of new software development, but also help grow the number of active participants in a long-term manner. Most of our core developers started as students, but have since moved on from their student days. Attracting and retaining students is essential to the health and sustainability of our project and is an important goal for all of us.

The Icecast multimedia streaming project has recently regained development momentum, but we are looking to involve more people, especially students. This should help us sustain momentum and strengthen our team.

==== Has your organization participated in past Google Summer of Codes? ====

Yes

==== If you answered “yes” to the question above, please summarize your involvement and the successes and challenges of your participation. Please also list your pass/fail rate for each year. ====

The Xiph.Org Foundation was invited to participate in GSoc in 2006, 2007, 2008 and 2009, and mentored Annodex-related projects as well.

In 2006, we were granted funding for 6 slots. One we weren't able to fill because our chosen students picked or were assigned to other projects.

Two were [http://code.google.com/soc/xiph/about.html successful]. One, a [http://code.google.com/soc/xiph/appinfo.html?csaid=5F9265EEC6FA0611 hardware implementation of a Theora decoder]: this project produced HDL implementation of the major decoder components, to be used with a general purpose CPU, such as the open source LEON sparc implementation. Real time playback of SD content was demonstrated using these components in combination with the proprietary Nagios CPU design. Two, [http://code.google.com/soc/xiph/appinfo.html?csaid=213E2D30F095565D implementation of OggSkeleton support] in various tools. We have maintained contact with the two successful students since the program finished. One has continued to contribute code outside the GSoC term, continuing related work.

The remaining three were unsuccessful through lack of necessary skills, health complications, insufficient motivation, or some combination of all of these.

In 2007, we were given 2 project slots. One was an extension of the hardware decoder effort from last year. The other was helping to do R&D on Xiph's next-generation audio codec, Ghost. Both were marginally successful — the students reached the minimum goals set, but little more, and did not maintain contact with Xiph after the program.

We participated in 2008 and 2009. Sadly at this time we're unable to locate a report about both years and must assume that both were unsuccessful.

We enjoyed our participation over the last years. It provided needed external input, energizing our project and improving our connections to the rest of the open source community. We'd like to take the opportunity, reset and be part in this years Summer of code with a focus on Icecast, also avoiding the previous emphasis on codecs, as it proved very challenging to most student participants.

==== If your organization has not previously participated in Google Summer of Code, have you applied in the past? If so, for what year(s)? ====

We have participated previously, in 2006, 2007, 2008 and 2009.
We applied in 2010, but weren't chosen.

==== What Open Source Initiative approved license(s) does your project use? ====

In general, we use the revised 3-clause BSD license for our libraries, to enable the widest possible uses of our formats and reference implementations.

Our applications are generally GPL, LGPL or (GPL-compatible) modified. BSD is also acceptable.

==== What is the URL for your Ideas list? ====

http://wiki.xiph.org/Summer_of_Code_2015

==== What is the main development mailing list for your organization? ====

Icecast will be the main Xiph.org project for GSoC this year.

[http://lists.xiph.org/mailman/admindb/icecast-dev Icecast developer mailing list]

[http://dir.gmane.org/gmane.comp.audio.icecast.devel Gmane archive of the Icecast developer mailing list]

A complete listing of our lists is available at:

http://lists.xiph.org/mailman/listinfo/

==== What is the main IRC channel for your organization? ====

The main channel for Xiph.org is [http://webchat.freenode.net?nick=gsoc.&channels=%23xiph&prompt=1&uio=d4 #xiph on Freenode]
The main Icecast channel is [http://webchat.freenode.net?nick=gsoc.&channels=%23icecast&prompt=1&uio=d4 #icecast on Freenode]

==== Who will be your backup organization administrator? ====

'''tbd'''

==== Does your organization have an application template you would like to see students use? If so, please provide it now. ====

http://wiki.xiph.org/index.php/Summer_of_Code_Applications

==== What criteria did you use to select the mentors? Please be as specific as possible. ====

We selected our mentors from the 'core' developers and contributors within Xiph. Mentors were selected based on how well they know the code area they're volunteering to mentor, how long they've been part of Xiph, how well they interact with others (particularly in terms of building community around our projects).

The majority of the mentors we've selected are core developers on the various Xiph sub-projects that they've volunteered to mentor for. They have been contributing to the Xiph.Org Foundation for at least several years, and have shown a persistent interest both in the software we develop, and in helping to create a community around it. We have also made sure that each mentor has sufficient time available to adequately mentor their student(s).

'''''TODO: Introduce mentors briefly.'''''
==== What is your plan for dealing with disappearing students? Please be as specific as possible. ====
Our first goal will be to provide necessary support from the community such that our students do not want to suddenly vanish. We want our students to become well integrated members of the community, with ongoing contributions. That said, we're well aware of the possibility of a student disappearing.

We intend to be reasonably strict with requiring students to keep in touch - whilst we're quite happy for them to be absent for a while if they let us know in advance, we will intend to get at least twice-weekly updates from each student.

The mentors will have primary responsibility for their students, but the admins are also going to ensure that the mentors are indeed keeping track of what their students are up to. We'll ask our students to provide means for us to get in touch beyond email, where possible - phone, etc - in case we need to get in touch urgently.

==== What is your plan for dealing with disappearing mentors? Please be as specific as possible. ====

Our mentors are all people who are major contributors to the Xiph projects - and have generally been contributing for many years. So, we think it's pretty unlikely that a mentor will disappear. However, we do have more mentors available than we expect to eventually have students (based on past years), so we're well able to take up the slack if a mentor becomes unavailable for any reason.

Our admins will ensure that the mentors are keeping up with the students appropriately, and should it be absolutely necessary, we will either find another appropriate mentor, or the admins will take over mentoring the students directly.

==== What steps will you take to encourage students to interact with your project's community before, during and after the program? ====

The Xiph.Org Founation conducts much of its development discussion and community-building on our IRC channels. We'll ask that the students be present there while they're working, where adequate network access makes that possible. We hope to make them feel that they're an important part of our community; that their contributions are really making a difference towards the goals of Xiph.

We intend to be open to their contributions - whilst we're aware that initially their work may not be of a quality sufficient to go into our core codebase immediately, we'll give them write access to our repositories to work on a branch. We'll ask them to be open in discussing and designing their contributions on IRC and our mailing lists. Our application template welcomes them to come and ask us questions when they're trying to write up their application. We hope that some, or even all, of the students will continue to be part of the Xiph community after SoC concludes. For those students who have not previously contributed to open source software, we'll teach them about how important community building is for the ongoing health of such projects.

==== Are you a new organization who has a Googler or other organization to vouch for you? If so, please list their name(s) here. ====

We are a well established organization and participated in GSoC in the past.

==== Are you an established or larger organization who would like to vouch for a new organization applying this year? If so, please list their name(s) here. ====

==== What will you do to encourage that your accepted students stick with the project after Google Summer of Code concludes? ====

We hope that the mentoring process and the experiences they have as part of GSoC will make the students interested in remaining part of Xiph, continuing development on the software they've been working on, and perhaps nurturing their patches towards inclusion in an actual release.

A very important part of GSoC is for us to make them active members of the community, in particular on the irc channels and the mailing lists. Past experience tells that once they have become part of that community, they will stick around for longer.

We will encourage them not to consider this just "a summer job", but as being part of a real community — and doing something that is both interesting, and useful to the wider world.

==== Additional items not listed by the GSoC FAQ ====
===== Who will be your main organization administrator =====

Thomas B. Rücker, maintainer of the Icecast project.

===== Who will your mentors be? =====

* '''Thomas B. Rücker''' - IRC nick: ''tbr''
* '''NN''' - IRC nick:

Icecast Server/Git workflow

2015-02-15T08:54:19Z

Dm8tbr: /* Updating the local repository */ added info on avoiding unnecessary git merge commits on pull of origin/master

The Icecast project recently migrated from Subversion to Git, this page outlines how to get started with it!

== Repositories ==

The repositories are at [https://git.xiph.org git.xiph.org] and are mirrored to [https://github.com/xiph GitHub]. All repository names start with "icecast-" for clarity.
{| class="wikitable"
|Name
|Anonymous access URL
|SSH URL (only project members)
|Comments
|-
|[https://git.xiph.org/?p=icecast-server.git Icecast server]
|<code><nowiki>https://git.xiph.org/icecast-server.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-server.git</code>
|
|-
|[https://git.xiph.org/?p=icecast-ices.git IceS]
|<code><nowiki>https://git.xiph.org/icecast-ices.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-ices.git</code>
|
|-
|[https://git.xiph.org/?p=icecast-libshout.git libshout]
|<code><nowiki>https://git.xiph.org/icecast-libshout.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-libshout.git</code>
|
|-
|[https://git.xiph.org/?p=icecast-directory.git Icecast directory]
|<code><nowiki>https://git.xiph.org/icecast-directory.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-directory.git</code>
|As seen running on http://dir.xiph.org - soon™
|-
|[https://git.xiph.org/?p=icecast-common.git Icecast shared code]
|<code><nowiki>https://git.xiph.org/icecast-common.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-common.git</code>
|No need to check out separately, see below.
|-
|[https://git.xiph.org/?p=icecast-m4.git Icecast shared autofoo]
|<code><nowiki>https://git.xiph.org/icecast-m4.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-m4.git</code>
|No need to check out separately, see below.
|}

The repositories were migrated with their full history, but for reference the old subversion repository structure remains [https://trac.xiph.org/browser/icecast/ browseable] and all subprojects can be checked out below <nowiki>http://svn.xiph.org/icecast/trunk/</nowiki><projectname>. This might be useful in case of some branches (not all were migrated) and no longer maintained projects that were not migrated to Git.

== Cloning the Repo ==
First you need to clone the Git repository, because we use submodules, these should also be cloned, do to this, run:

<code><pre>git clone --recursive ssh://git@git.xiph.org/icecast-server.git</pre></code>

If your Git version (<code>git --version</code>) is lower then 1.6.5, do:

<code>
<pre>git clone ssh://git@git.xiph.org/icecast-server.git
cd icecast-server
git submodule update --init</pre>
</code>

== Initializing the Submodules ==
The steps we did above, for cloning, initialized the Submodules, but if you want to do any changes to them
and push them back to the remote repository, we need to set them to a specific branch, in this case, master.

First of all, checkout the master branch, depending on your git version, your modules may be initialized in a detached HEAD state.

<code><pre>git submodule foreach git checkout master</pre></code>

(If your git version does not support this, <code>cd</code> into each submodule and run <code>git checkout master</code>)

== Pushing changes to a remote Server ==
When you are done with some super cool new feature, or even while working on it, you may want to push your current state to the remote repository, so others can test it and give you
some Feedback!
For this example let's assume you've built an ACL, therefore changed something in httpp.c which is in the common submodule and changed a lot of stuff in parent repository.

First you need to commit the changed you made in the common submodule, so <code>cd</code> into it, and do

<code><pre>git status</pre></code>

This will list you the changes you made, each change you want to have in the commit needs to be added, let's assume (which is the most common case) you want to commit all changes.
You could either do <code>git add .</code> or even shorter:

<code><pre>git commit -a</pre></code>

The <code>-a</code> or <code>--all</code> option will add all changed or deleted files, but not add any untracked files.

Now enter a meaningful commit message, the first line should be a rough summary, followed by two newlines and a more verbose description. Less is not more in this case, that’s what the summary is for.

Ok now it's time to push the changes to the remote server, if this is the first time you do this, you might need to set the origin url, because it defaults to a http(s) one, so that people without ssh access can clone the repository and submodules too, but for cloning you want to use ssh. Let’s set the remote origin like this:

<code><pre>git remote set-url origin ssh://git@git.xiph.org/icecast-common.git</pre></code>

Now push the changes to the remote location:

<code><pre>git push origin master</pre></code>

This tells git to push your copy of the master branch to the remote location origin (that we’ve just set to the right url).

Ok now that we cared about the submodule, let's <code>cd</code> back into the parent repository, and commit the changes we made there:

<code><pre>git commit -a</pre></code>

Now enter a meaningful commit message. (Yes, I sound like a broken record, but this is important)

Push the stuff to the remote:

<code><pre>git push origin master</pre></code>

(If you are on a different branch than master, you probably want to replace master with the branch you are on, obviously, or just do <code>git push</code>)

NOTE: Even if you hadn't changed anything in the parent repository but just in the submodule repository, you would need to commit the change of the version of the submodule to the parent repository. If you just had updated the httpp.c you still would needed to do <code>git commit -a -m "Update commons to recent version for latest httpp changes"</code>, and push it, to make the parent repository point to the right submodule version.

== Updating the local repository ==
Let's say someone else committed something and pushed it, and you want to update your local copy to the one of the remote. Let's assume you have nothing changed, so you are just a bit behind in history, then it is a simple as:

<code><pre>git pull</pre></code>

and

<code><pre>git submodule update</pre></code>

to make sure submodules are up to date too.

If something changed, then git needs to reconcile the local changes and the remote changes. We prefer to avoid merge commits, unless there is a larger branch developed feature.

This can be either accomplished by always running:

<code><pre>git pull --rebase</pre></code>

Or by setting up git to do this automatically for you. The following passage is taken verbatim from [https://coderwall.com/p/tnoiug/rebase-by-default-when-doing-git-pull Marcin Kulik's blog post on the same topic]

''In git >= 1.7.9:''

<code><pre>git config --global pull.rebase true</pre></code>

''In git < 1.7.9:''

<code><pre>git config --global branch.autosetuprebase always</pre></code>

''The latter has the effect of automatically adding branch.<name>.rebase true for each checked out local branch that is tracking an upstream branch to the repository config file.''

''Note that if you have both options set (not really recommended) then branch.<name>.rebase true that is automatically added for each branch takes precedence over global pull.rebase true.''

[[Category: Icecast]]

Summer of Code 2015

2015-02-14T14:46:21Z

Dm8tbr: /* Investigate URL-Auth (D)DoS Possibilities */ slight clean up

Icecast Server/YP-protocol-v2

2015-02-08T16:46:40Z

Dm8tbr: We do explain this in the documentation already, this is a technical collaboration page for people already familiar with the YP protocol.

This page is to document and help collaborate on drafting and later finalizing a complete revision of the Icecast YP protocol and YP server behaviour.

== Known deficiencies of the old protocol ==

== New to be introduced features ==

== Design goals for the new revision ==

Icecast Server/YP-protocol-v2

2015-02-08T10:28:37Z

Dm8tbr: initial content

Summer of Code 2015

2015-01-25T13:40:29Z

Dm8tbr: added https let's encrypt

Summer of Code 2015

2015-01-19T07:50:01Z

Dm8tbr: /* Solution / Task */

Summer of Code 2015

2015-01-19T07:43:39Z

Dm8tbr: /* Streaming / Icecast */ moved note to the bottom

Summer of Code 2015

2015-01-19T07:36:16Z

Dm8tbr: Added YP-API related things

Summer of Code

2015-01-18T15:24:54Z

Dm8tbr: added 2015

*see [[Summer of Code 2015]]
*see [[Summer of Code 2009]]
*see [[Summer of Code 2008]]
*see [[Summer of Code 2010]] (Xiph.org was not a mentoring organzation in 2010)

Summer of Code 2015

2015-01-18T15:23:30Z

Dm8tbr: initial content, structure taken from previous years

Summer of Code Mentoring

2015-01-18T14:50:45Z

Dm8tbr: removed annodex mentions, this year there is main interest from Icecast within Xiph.org. reworked existing list to fit current FAQ, left a few blanks where we still need to decide things.

== Xiph.Org Application as a mentoring organization ==

We need to apply for consideration as a mentoring organization 2015 February 9 - 20. Google lists the following questions in their [http://www.google-melange.com/gsoc/document/show/gsoc_program/google/gsoc2015/help_page#1._How_does_a_mentoring_organization faq]. Our work-in-progress answers are inline.

==== Describe your organization. ====

The Xiph.Org Foundation is a 501(c)(3) non-profit organization dedicated to providing open and free-to-implement multimedia technology as a foundation for an interoperable, level playing field on the Internet and other digital distribution networks. Over the past 14 years we have developed most of the major patent-free and royalty-free audio and video codecs currently in use, including Opus, Vorbis, Speex, FLAC and Theora, as well as developing the Ogg streaming format, and the Icecast streaming media server. Xiph hosted libraries like liboggplay and liboggz power the underling html5 video support in Mozilla Firefox.

==== Why is your organization applying to participate in Google Summer of Code 2015? What do you hope to gain by participating? ====

We believe that the Xiph.Org Foundation and specifically the Icecast Project has a wide-ranging set of projects that are both challenging and educational for students. Furthermore, they are important/useful goals for the wider technology community, and especially users of open source software.

We believe that Xiph's mandate to develop multimedia standards and software is an important one, but as a small non-profit with no official staff we—of course—have limited resources. We hope that the results of GSoC will include the direct benefit of new software development, but also help grow the number of active participants in a long-term manner. Most of our core developers started as students, but have since moved on from their student days. Attracting and retaining students is essential to the health and sustainability of our project and is an important goal for all of us.

The Icecast multimedia streaming project has recently regained development momentum, but we are looking to involve more people, especially students. This should help us sustain momentum and strengthen our team.

==== Has your organization participated in past Google Summer of Codes? ====

Yes

==== If you answered “yes” to the question above, please summarize your involvement and the successes and challenges of your participation. Please also list your pass/fail rate for each year. ====

The Xiph.Org Foundation was invited to participate in GSoc in 2006, 2007, 2008 and 2009, and mentored Annodex-related projects as well.

In 2006, we were granted funding for 6 slots. One we weren't able to fill because our chosen students picked or were assigned to other projects.

Two were [http://code.google.com/soc/xiph/about.html successful]. One, a [http://code.google.com/soc/xiph/appinfo.html?csaid=5F9265EEC6FA0611 hardware implementation of a Theora decoder]: this project produced HDL implementation of the major decoder components, to be used with a general purpose CPU, such as the open source LEON sparc implementation. Real time playback of SD content was demonstrated using these components in combination with the proprietary Nagios CPU design. Two, [http://code.google.com/soc/xiph/appinfo.html?csaid=213E2D30F095565D implementation of OggSkeleton support] in various tools. We have maintained contact with the two successful students since the program finished. One has continued to contribute code outside the GSoC term, continuing related work.

The remaining three were unsuccessful through lack of necessary skills, health complications, insufficient motivation, or some combination of all of these.

In 2007, we were given 2 project slots. One was an extension of the hardware decoder effort from last year. The other was helping to do R&D on Xiph's next-generation audio codec, Ghost. Both were marginally successful — the students reached the minimum goals set, but little more, and did not maintain contact with Xiph after the program.

We enjoyed our participation over the last two years. It provided needed external input, energizing our project and improving our connections to the rest of the open source community. We think we've learnt a lot about how to mentor new and upcoming contributors, and how to best screen the applications we do receive.

'''TODO: In 2008'''

'''TODO: In 2009'''

==== If your organization has not previously participated in Google Summer of Code, have you applied in the past? If so, for what year(s)? ====

We have participated previously, in 2006, 2007, 2008 and 2009.
We applied in 2010, but weren't chosen.

==== What Open Source Initiative approved license(s) does your project use? ====

In general, we use the revised 3-clause BSD license for our libraries, to enable the widest possible uses of our formats and reference implementations.

Our applications are generally GPL, LGPL or (GPL-compatible) modified. BSD is also acceptable.

==== What is the URL for your Ideas list? ====

http://wiki.xiph.org/Summer_of_Code_2015

==== What is the main development mailing list for your organization? ====

Icecast will be the main Xiph.org project for GSoC this year.

[http://lists.xiph.org/mailman/admindb/icecast-dev Icecast developer mailing list]

[http://dir.gmane.org/gmane.comp.audio.icecast.devel Gmane archive of the Icecast developer mailing list]

A complete listing of our lists is available at:

http://lists.xiph.org/mailman/listinfo/

==== What is the main IRC channel for your organization? ====

The main channel for Xiph.org is [http://webchat.freenode.net?nick=gsoc.&channels=%23xiph&prompt=1&uio=d4 #xiph on Freenode]
The main Icecast channel is [http://webchat.freenode.net?nick=gsoc.&channels=%23icecast&prompt=1&uio=d4 #icecast on Freenode]

==== Who will be your backup organization administrator? ====

'''tbd'''

==== Does your organization have an application template you would like to see students use? If so, please provide it now. ====

http://wiki.xiph.org/index.php/Summer_of_Code_Applications

==== What criteria did you use to select the mentors? Please be as specific as possible. ====

We selected our mentors from the 'core' developers and contributors within Xiph. Mentors were selected based on how well they know the code area they're volunteering to mentor, how long they've been part of Xiph, how well they interact with others (particularly in terms of building community around our projects).

The majority of the mentors we've selected are core developers on the various Xiph sub-projects that they've volunteered to mentor for. They have been contributing to the Xiph.Org Foundation for at least several years, and have shown a persistent interest both in the software we develop, and in helping to create a community around it. We have also made sure that each mentor has sufficient time available to adequately mentor their student(s).

'''''TODO: Introduce mentors briefly.'''''
==== What is your plan for dealing with disappearing students? Please be as specific as possible. ====
Our first goal will be to provide necessary support from the community such that our students do not want to suddenly vanish. We want our students to become well integrated members of the community, with ongoing contributions. That said, we're well aware of the possibility of a student disappearing.

We intend to be reasonably strict with requiring students to keep in touch - whilst we're quite happy for them to be absent for a while if they let us know in advance, we will intend to get at least twice-weekly updates from each student.

The mentors will have primary responsibility for their students, but the admins are also going to ensure that the mentors are indeed keeping track of what their students are up to. We'll ask our students to provide means for us to get in touch beyond email, where possible - phone, etc - in case we need to get in touch urgently.

==== What is your plan for dealing with disappearing mentors? Please be as specific as possible. ====

Our mentors are all people who are major contributors to the Xiph projects - and have generally been contributing for many years. So, we think it's pretty unlikely that a mentor will disappear. However, we do have more mentors available than we expect to eventually have students (based on past years), so we're well able to take up the slack if a mentor becomes unavailable for any reason.

Our admins will ensure that the mentors are keeping up with the students appropriately, and should it be absolutely necessary, we will either find another appropriate mentor, or the admins will take over mentoring the students directly.

==== What steps will you take to encourage students to interact with your project's community before, during and after the program? ====

The Xiph.Org Founation conducts much of its development discussion and community-building on our IRC channels. We'll ask that the students be present there while they're working, where adequate network access makes that possible. We hope to make them feel that they're an important part of our community; that their contributions are really making a difference towards the goals of Xiph.

We intend to be open to their contributions - whilst we're aware that initially their work may not be of a quality sufficient to go into our core codebase immediately, we'll give them write access to our repositories to work on a branch. We'll ask them to be open in discussing and designing their contributions on IRC and our mailing lists. Our application template welcomes them to come and ask us questions when they're trying to write up their application. We hope that some, or even all, of the students will continue to be part of the Xiph community after SoC concludes. For those students who have not previously contributed to open source software, we'll teach them about how important community building is for the ongoing health of such projects.

==== Are you a new organization who has a Googler or other organization to vouch for you? If so, please list their name(s) here. ====

We are a well established organization and participated in GSoC in the past.

==== Are you an established or larger organization who would like to vouch for a new organization applying this year? If so, please list their name(s) here. ====

==== What will you do to encourage that your accepted students stick with the project after Google Summer of Code concludes? ====

We hope that the mentoring process and the experiences they have as part of GSoC will make the students interested in remaining part of Xiph, continuing development on the software they've been working on, and perhaps nurturing their patches towards inclusion in an actual release.

A very important part of GSoC is for us to make them active members of the community, in particular on the irc channels and the mailing lists. Past experience tells that once they have become part of that community, they will stick around for longer.

We will encourage them not to consider this just "a summer job", but as being part of a real community — and doing something that is both interesting, and useful to the wider world.

==== Additional items not listed by the GSoC FAQ ====
===== Who will be your main organization administrator =====

Thomas B. Rücker, maintainer of the Icecast project.

===== Who will your mentors be? =====

* '''Thomas B. Rücker''' - IRC nick: ''tbr''
* '''NN''' - IRC nick:

Icecast Server

2015-01-18T10:21:55Z

Dm8tbr: minor tweaks and spelling

[[File:Icecast_Logo.svg|100px|left]]
Icecast is a streaming media server which currently supports [[Ogg]] ([[Vorbis]] and [[Theora]]), [[Opus]] and WebM streams. 
MP3 works too, but it is not officially supported due to its non-free nature.

It can be used to create an Internet radio station or a privately-running jukebox and many things in between. 
It is very versatile in that new formats can be added relatively easily and supports open standards for communication and interaction.

Icecast is distributed under the GNU GPL, version 2.

== Icecast Articles ==

{{Special:PrefixIndex/Icecast/}}

== External Links ==

* [http://www.icecast.org/ Icecast homepage]
* [http://dir.xiph.org/index.php Stream directory]
* [http://dir.gmane.org/gmane.comp.audio.icecast.general Icecast mailing list archive] - You can search or browse Icecast user discussions here.
* [http://dir.gmane.org/gmane.comp.audio.icecast.devel Icecast developer mailing list archive] - You can search or browse Icecast discussions on icecast development here.

== Development ==

You can find more information about the [[Icecast/Git_workflow|development workflow]] on a dedicated wiki page.

== Wish List ==

As good ideas are never a waste (and for tracking purposes) please list all the features you're missing in the icecast trunk as separate tickets on [https://trac.xiph.org/newticket?component=Icecast%20Server trac.xiph.org].

Note: please check that the feature you request is not already in trunk before posting!

[[Category:Icecast]]

__NOTOC__

Icecast Server

2015-01-18T09:04:09Z

Dm8tbr: /* External Links */ - nabble is gone, replace with links to much better gmane interface

[[File:Icecast_Logo.svg|100px|left]]
Icecast is a streaming media server which currently supports [[Ogg]] ([[Vorbis]] and [[Theora]]), [[Opus]] and WebM audio streams. 
MP3 works too, but it is not officially supported due to its non-free nature.

It can be used to create an Internet radio station or a privately-running jukebox and many things inbetween. 
It is very versatile in that new formats can be added relatively easily and supports open standards for communication and interaction.

Icecast is distributed under the GNU GPL, version 2.

== Icecast Articles ==

{{Special:PrefixIndex/Icecast/}}

== External Links ==

* [http://www.icecast.org/ Icecast homepage]
* [http://dir.xiph.org/index.php Stream directory]
* [http://dir.gmane.org/gmane.comp.audio.icecast.general Icecast mailing list archive] - You can search or browse Icecast user discussions here.
* [http://dir.gmane.org/gmane.comp.audio.icecast.devel Icecast developer mailing list archive] - You can search or browse Icecast discussions on icecast development here.

== Development ==

You can find more information about the [[Icecast/Git_workflow|development workflow]] on a dedicated wiki page.

== Wish List ==

As good ideas are never a waste (and for tracking purposes) please list all the features you're missing in the icecast trunk as separate tickets on [https://trac.xiph.org/newticket?component=Icecast%20Server trac.xiph.org].

Note: please check that the feature you request is not already in trunk before posting!

[[Category:Icecast]]

__NOTOC__

Icecast Server

2015-01-18T08:50:38Z

Dm8tbr: /* Development */ - Link to workflow page instead

[[File:Icecast_Logo.svg|100px|left]]
Icecast is a streaming media server which currently supports [[Ogg]] ([[Vorbis]] and [[Theora]]), [[Opus]] and WebM audio streams. 
MP3 works too, but it is not officially supported due to its non-free nature.

It can be used to create an Internet radio station or a privately-running jukebox and many things inbetween. 
It is very versatile in that new formats can be added relatively easily and supports open standards for communication and interaction.

Icecast is distributed under the GNU GPL, version 2.

== Icecast Articles ==

{{Special:PrefixIndex/Icecast/}}

== External Links ==

* [http://www.icecast.org/ Icecast homepage]
* [http://dir.xiph.org/index.php Stream directory]
* [http://www.nabble.com/Icecast-f2880.html Icecast archive] - an Icecast mailing list archive that combines both user and dev lists. It is hosted by [http://www.nabble.com/ Nabble]. You can search or browse Icecast discussions here.

== Development ==

You can find more information about the [[Icecast/Git_workflow|development workflow]] on a dedicated wiki page.

== Wish List ==

As good ideas are never a waste (and for tracking purposes) please list all the features you're missing in the icecast trunk as separate tickets on [https://trac.xiph.org/newticket?component=Icecast%20Server trac.xiph.org].

Note: please check that the feature you request is not already in trunk before posting!

[[Category:Icecast]]

__NOTOC__

Icecast Server/Git workflow

2014-12-04T12:25:32Z

Dm8tbr: approx %s/icecast\//icecast-/g - aka still fixing repository names

The Icecast project recently migrated from Subversion to Git, this page outlines how to get started with it!

== Repositories ==

The repositories are at [https://git.xiph.org git.xiph.org] and are mirrored to [https://github.com/xiph GitHub]. All repository names start with "icecast-" for clarity.
{| class="wikitable"
|Name
|Anonymous access URL
|SSH URL (only project members)
|Comments
|-
|[https://git.xiph.org/?p=icecast-server.git Icecast server]
|<code><nowiki>https://git.xiph.org/icecast-server.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-server.git</code>
|
|-
|[https://git.xiph.org/?p=icecast-ices.git IceS]
|<code><nowiki>https://git.xiph.org/icecast-ices.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-ices.git</code>
|
|-
|[https://git.xiph.org/?p=icecast-libshout.git libshout]
|<code><nowiki>https://git.xiph.org/icecast-libshout.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-libshout.git</code>
|
|-
|[https://git.xiph.org/?p=icecast-directory.git Icecast directory]
|<code><nowiki>https://git.xiph.org/icecast-directory.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-directory.git</code>
|As seen running on http://dir.xiph.org - soon™
|-
|[https://git.xiph.org/?p=icecast-common.git Icecast shared code]
|<code><nowiki>https://git.xiph.org/icecast-common.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-common.git</code>
|No need to check out separately, see below.
|-
|[https://git.xiph.org/?p=icecast-m4.git Icecast shared autofoo]
|<code><nowiki>https://git.xiph.org/icecast-m4.git</nowiki></code>
|<code>ssh://git@git.xiph.org/icecast-m4.git</code>
|No need to check out separately, see below.
|}

The repositories were migrated with their full history, but for reference the old subversion repository structure remains [https://trac.xiph.org/browser/icecast/ browseable] and all subprojects can be checked out below <nowiki>http://svn.xiph.org/icecast/trunk/</nowiki><projectname>. This might be useful in case of some branches (not all were migrated) and no longer maintained projects that were not migrated to Git.

== Cloning the Repo ==
First you need to clone the Git repository, because we use submodules, these should also be cloned, do to this, run:

<code><pre>git clone --recursive ssh://git@git.xiph.org/icecast-server.git</pre></code>

If your Git version (<code>git --version</code>) is lower then 1.6.5, do:

<code>
<pre>git clone ssh://git@git.xiph.org/icecast-server.git
cd icecast
git submodule update --init</pre>
</code>

== Initializing the Submodules ==
The steps we did above, for cloning, initialized the Submodules, but if you want to do any changes to them
and push them back to the remote repository, we need to set them to a specific branch, in this case, master.

First of all, checkout the master branch, depending on your git version, your modules may be initialized in a detached HEAD state.

<code><pre>git submodule foreach git checkout master</pre></code>

(If your git version does not support this, <code>cd</code> into each submodule and run <code>git checkout master</code>)

== Pushing changes to a remote Server ==
When you are done with some super cool new feature, or even while working on it, you may want to push your current state to the remote repository, so others can test it and give you
some Feedback!
For this example let's assume you've built an ACL, therefore changed something in httpp.c which is in the common submodule and changed a lot of stuff in parent repository.

First you need to commit the changed you made in the common submodule, so <code>cd</code> into it, and do

<code><pre>git status</pre></code>

This will list you the changes you made, each change you want to have in the commit needs to be added, let's assume (which is the most common case) you want to commit all changes.
You could either do <code>git add .</code> or even shorter:

<code><pre>git commit -a</pre></code>

The <code>-a</code> or <code>--all</code> option will add all changed or deleted files, but not add any untracked files.

Now enter a meaningful commit message, the first line should be a rough summary, followed by two newlines and a more verbose description. Less is not more in this case, that’s what the summary is for.

Ok now it's time to push the changes to the remote server, if this is the first time you do this, you might need to set the origin url, because it defaults to a http(s) one, so that people without ssh access can clone the repository and submodules too, but for cloning you want to use ssh. Let’s set the remote origin like this:

<code><pre>git remote set-url origin ssh://git@git.xiph.org/icecast-common.git</pre></code>

Now push the changes to the remote location:

<code><pre>git push origin master</pre></code>

This tells git to push your copy of the master branch to the remote location origin (that we’ve just set to the right url).

Ok now that we cared about the submodule, let's <code>cd</code> back into the parent repository, and commit the changes we made there:

<code><pre>git commit -a</pre></code>

Now enter a meaningful commit message. (Yes, I sound like a broken record, but this is important)

Push the stuff to the remote:

<code><pre>git push origin master</pre></code>

(If you are on a different branch than master, you probably want to replace master with the branch you are on, obviously, or just do <code>git push</code>)

NOTE: Even if you hadn't changed anything in the parent repository but just in the submodule repository, you would need to commit the change of the version of the submodule to the parent repository. If you just had updated the httpp.c you still would needed to do <code>git commit -a -m "Update commons to recent version for latest httpp changes"</code>, and push it, to make the parent repository point to the right submodule version.

== Updating the local repository ==
Let's say someone else committed something and pushed it, and you want to update your local copy to the one of the remote. Let's assume you have nothing changed, so you are just a bit behind in history, then it is a simple as:

<code><pre>git pull</pre></code>

and

<code><pre>git submodule update</pre></code>

to make sure submodules are up to date too.

[[Category: Icecast]]

Icecast Server/Git workflow

2014-12-03T16:09:01Z

Dm8tbr: added a table of all icecast project git repositories.

The Icecast project recently migrated from Subversion to Git, this page outlines how to get started with it!

== Repositories ==

The repositories are at [https://git.xiph.org git.xiph.org] and are mirrored to [https://github.com/xiph GitHub]. All repository names start with "icecast/" for clarity.
{| class="wikitable"
|name
|anonymous access URL
|SSH URL (only project members)
|comments
|-
|Icecast server
|https://git.xiph.org/icecast/icecast.git
|ssh://git@git.xiph.org/icecast/icecast.git
|
|-
|IcesS
|https://git.xiph.org/icecast/ices.git
|ssh://git@git.xiph.org/icecast/ices.git
|
|-
|libshout
|https://git.xiph.org/icecast/libshout.git
|ssh://git@git.xiph.org/icecast/libshout.git
|
|-
|Icecast directory
|https://git.xiph.org/icecast/directory.git
|ssh://git@git.xiph.org/icecast/directory.git
|As seen running on https://dir.xiph.org - soon™
|-
|Icecast shared code
|https://git.xiph.org/icecast/common.git
|ssh://git@git.xiph.org/icecast/common.git
|No need to check out separately, see below.
|-
|Icecast shared autofoo
|https://git.xiph.org/icecast/m4.git
|ssh://git@git.xiph.org/icecast/m4.git
|No need to check out separately, see below.
|}

The repositories were migrated with their full history, but for reference the old subversion repository structure remains [https://trac.xiph.org/browser/icecast/ browseable] and all subprojects can be checked out below <nowiki>http://svn.xiph.org/icecast/trunk/</nowiki><projectname>. This might be useful in case of some branches (not all were migrated) and no longer maintained projects that were not migrated to Git.

== Cloning the Repo ==
First you need to clone the Git repository, because we use submodules, these should also be cloned, do to this, run:

<code><pre>git clone --recursive ssh://git@git.xiph.org/icecast/icecast.git</pre></code>

If your Git version (<code>git --version</code>) is lower then 1.6.5, do:

<code>
<pre>git clone ssh://git@git.xiph.org/icecast/icecast.git
cd icecast
git submodule update --init</pre>
</code>

== Initializing the Submodules ==
The steps we did above, for cloning, already initialized the Submodules, but if you want to do any changes to them later
and push them back to the remote repository, we need to configure some things.

First of all, checkout the master branch, depending on your git version, your modules may be initialized in a detached HEAD state.

<code><pre>git submodule foreach git checkout master</pre></code>

(If your git version does not support this, <code>cd</code> into each submodule and run <code>git checkout master</code>)

== Pushing changes to a remote Server ==
When you are done with some super cool new feature, or even while working on it, you may want to push your current state to the remote repository, so others can test it and give you
some Feedback!
For this example let's assume you've built an ACL, therefore changed something in httpp.c which is in the common submodule and changed a lot of stuff in parent repository.

First you need to commit the changed you made in the common submodule, so <code>cd</code> into it, and do

<code><pre>git status</pre></code>

This will list you the changes you made, each change you want to have in the commit needs to be added, let's assume (which is the most common case) you want to commit all changes.
You could either do <code>git add .</code> or even shorter:

<code><pre>git commit -a</pre></code>

The <code>-a</code> or <code>--all</code> option will add all changed or deleted files, but not add any untracked files.

Now enter a meaningful commit message, the first line should be a rough summary, followed by two newlines and a more verbose description. Less is not more in this case, that’s what the summary is for.

Ok now it's time to push the changes to the remote server, if this is the first time you do this, you might need to set the origin url, because it defaults to a http(s) one, so that people without ssh access can clone the repository and submodules too, but for cloning you want to use ssh. Let’s set the remote origin like this:

<code><pre>git remote set-url origin ssh://git@git.xiph.org/icecast/common.git</pre></code>

Now push the changes to the remote location:

<code><pre>git push origin master</pre></code>

This tells git to push your copy of the master branch to the remote location origin (that we’ve just set to the right url).

Ok now that we cared about the submodule, let's <code>cd</code> back into the parent repository, and commit the changes we made there:

<code><pre>git commit -a</pre></code>

Now enter a meaningful commit message. (Yes, I sound like a broken record, but this is important)

Push the stuff to the remote:

<code><pre>git push origin master</pre></code>

(If you are on a different branch than master, you probably want to replace master with the branch you are on, obviously, or just do <code>git push</code>)

NOTE: Even if you hadn't changed anything in the parent repository but just in the submodule repository, you would need to commit the change of the version of the submodule to the parent repository. If you just had updated the httpp.c you still would needed to do <code>git commit -a -m "Update commons to recent version for latest httpp changes"</code>, and push it, to make the parent repository point to the right submodule version.

== Updating the local repository ==
Let's say someone else committed something and pushed it, and you want to update your local copy to the one of the remote. Let's assume you have nothing changed, so you are just a bit behind in history, then it is a simple as:

<code><pre>git pull</pre></code>

and

<code><pre>git submodule update</pre></code>

to make sure submodules are up to date too.

Icecast Server/Release Checklist

2013-04-06T14:57:18Z

Dm8tbr: removed stray questionmark

* Update documentation
* Check version in configure.in
* Ensure everything is committed
* Test on all Release critical systems
* Test on all other systems you have access to
* Update README, NEWS, HACKING and TODO
* Update and set release date in ChangeLog
* Ensure everything is committed including last changes to ChangeLog.
* Tag the release in VCS
* make distcheck
* commit resulting tarball to releases directory for replication
* update download page
* update news page
* add "Version" and close "Milestone" in trac
* post on IRC (+topic)
* post on icecast and icecast-dev
* create downstream bugs to facilitate adoption

== packaging specific ==
* update debian packaging
** copy and rename release tar-ball
** unpack debian.tar
** add release to 'changelog'
** tar up with right name
** verify version and checksums are correct in .dsc
* update RPM packaging
** change version in .spec
** change tarball name in .spec
** change debian tarball name in .spec
** update icecast-fix-no-add-needed.patch to apply cleanly
* windows
** TBD
* OBS
** osc delete all old files (tarballs)
** osc add new files (tarballs)
** (build locally -- feeling lucky, punk?)
** osc commit
** verify builds on dashboard and in repos

Icecast Server

2013-04-06T13:46:04Z

Dm8tbr: removed kh diff as it was outdated, needs to be rewritten. Wishlist got implemented, now repointed to trac.

'''Icecast''' is an open source multi-platform streaming server. It supports [[Ogg]] [[Vorbis]], Ogg [[Theora]], [[Opus]], WebM and MP3.

== External links ==

* [http://www.icecast.org/ Icecast homepage]
* [http://dir.xiph.org/index.php Stream directory]
* [http://www.nabble.com/Icecast-f2880.html Icecast archive] - an Icecast mailing list archive that combines both user and dev lists. It is hosted by [http://www.nabble.com/ Nabble]. You can search or browse Icecast discussions here.

== Development ==

*trunk http://svn.xiph.org/icecast/trunk/icecast
*kh-branch https://github.com/karlheyes/icecast-kh

== Wish List ==

As good ideas are never a waste, and for tracking purposes, please list all the features you're missing in icecast trunk as separate tickets on https://trac.xiph.org/newticket

Note: please check that the feature you request is not already in trunk before posting !

[[Category:Xiph-related Software]]

Icecast Server/Release Checklist

2013-04-06T13:37:08Z

Dm8tbr: initial version

* Update documentation
* Check version in configure.in
* Ensure everything is committed
* Test on all Release critical systems?
* Test on all other systems you have access to
* Update README, NEWS, HACKING and TODO
* Update and set release date in ChangeLog
* Ensure everything is committed including last changes to ChangeLog.
* Tag the release in VCS
* make distcheck
* commit resulting tarball to releases directory for replication
* update download page
* update news page
* add "Version" and close "Milestone" in trac
* post on IRC (+topic)
* post on icecast and icecast-dev
* create downstream bugs to facilitate adoption

== packaging specific ==
* update debian packaging
** copy and rename release tar-ball
** unpack debian.tar
** add release to 'changelog'
** tar up with right name
** verify version and checksums are correct in .dsc
* update RPM packaging
** change version in .spec
** change tarball name in .spec
** change debian tarball name in .spec
** update icecast-fix-no-add-needed.patch to apply cleanly
* windows
** TBD
* OBS
** osc delete all old files (tarballs)
** osc add new files (tarballs)
** (build locally -- feeling lucky, punk?)
** osc commit
** verify builds on dashboard and in repos

Icecast Server

2011-07-04T14:55:10Z

Dm8tbr: Undo revision 12883 by Frendie24 (talk) -- spam

'''Icecast''' is an open source multi-platform streaming server. It supports [[Ogg]] [[Vorbis]], Ogg [[Theora]], and [[MP3]].

== External links ==

* [http://www.icecast.org/ Icecast homepage]
* [http://dir.xiph.org/index.php Stream directory]
* [http://www.nabble.com/Icecast-f2880.html Icecast archive / forum] - an Icecast mailing list archive that combines both user and dev lists. It is hosted by [http://www.nabble.com/ Nabble]. You can search or browse Icecast discussions here.

== Development ==

*trunk http://svn.xiph.org/icecast/trunk/icecast
*kh-branch http://svn.xiph.org/icecast/branches/kh/icecast
**diff to trunk
***fast pre-buffering aka burst-on-connect. State a burst size in bytes to indicate how much should be sent at listener connect.
***mp3 accepts artist and title separately on the url.
***program invocation at stream start and end, per mount based.
***on-demand relays, activated on first listener, disconnected when listenersfalls to 0. Available for master relays as well.
***multiple Ogg codec streaming. Current codecs handled are Theora, Vorbis, Speex, Writ.
***Clients are started at theora key frame if theora is being streamed.
***Added URL and command based listener authentication
***server xml reload, and reopen logging available via admin url
***slave startup re-organised so that relays are more independant
***on xml reload, active sources are updated as well
***When max-listeners reached, a HTTP 302 code can be sent to redirect clients to alternative slave hosts.
***authenticated relays, those that match the relay user/pass, bypass the max-listener check

== Wish List ==

As good ideas are never a waste, and for tracking purposes, please list here all the features you're missing in icecast trunk.

Note: please check that the feature you request is not already in trunk before posting !

* Ponnies

[[Category:Xiph-related Software]]