[[Vorlage(Getestet, focal)]]
{{{#!vorlage Wissen
[:Pakete_installieren: Installation von Programmen]
[:Editor: Einen Editor öffnen]
[:Terminal: Ein Terminal öffnen]
}}}
[[Inhaltsverzeichnis(2)]]

[https://www.icecast.org Icecast2] {en} ist ein quelloffener Streaming-Server, der derzeit das [:Vorbis:Ogg Vorbis]- und MP3-Format unterstützt. Verschiedene Source-Clients können zum Icecast2 Server senden und fast jeder [:AudioPlayer:] kann den Stream empfangen. Icecast2 kann auch als Relay-Server für andere Icecast-, Icecast2- Server verwendet werden. 

Damit mehrere Radio-Sendungen auf einem Server gesendet werden können, sind die Streams auf einem Icecast-Server in Mountpoints organisiert. Der Moderator/DJ als [#SourceClients Source-Client] und die Zuhörer verbinden sich auf dem selben Port mit dem Mountpoint. 

= Installation =
Folgendes Paket muss installiert [1] werden: 

{{{#!vorlage Paketinstallation
icecast2, universe
}}}

= Benutzung =
In der Datei '''/etc/icecast2/icecast.xml''' müssen mindestens die Passwörter und der Hostname angepasst werden [2]. Weitere Einstellungen sind im Folgenden und in der Datei kommentiert. 

Abschließend muss der Eintrag ``ENABLE=false`` in der Datei '''/etc/default/icecast2''' auf ``ENABLE=true`` geändert werden [2]. 

Nun kann der Server gestartet werden [3]: 
{{{#!vorlage Befehl
sudo systemctl start icecast2
}}}

[[Bild(./icecast2webface_241.png, 200, right)]] 
== Webinterface ==
Das Webinterface ist jetzt ebenso auf dem Port 8000 zu erreichen, wie der voreingestellte Mountpoint '''/stream'''. Das Webinterface bietet Statistiken und eine einfache Möglichkeit, die Metadaten zum Stream im Betrieb zu aktuallisieren. 

Zur Administration über das Webinterface wird das in der Konfiguration festgelegte Passwort des Benutzers ``admin`` benötigt.
 
= Konfiguration =
Auf Grundlage der Datei '''/etc/icecast2/icecast.xml''' kann man in einem Texteditor mit Root-Rechten schnell eine neue Konfiguration des Icecast2-Servers erstellen, natürlich können beliebig viele Konfigurationen erstellt und unter verschiedenen Namen gespeichert werden [4]. 

== Allgemeiner Aufbau ==
Der einfachste Aufbau der Konfigurationsdatei ergibt sich ohne die Angabe eines Mountpoint, da der Standard-Mountpoint '''/stream''' vordefiniert ist. 
{{{<icecast>
 # Begrenzungen
 # Benutzer und Passwörter
 # Yellow Pages Einstellungen
 # übrige Server-Einstellungen
</icecast>
}}}

== Begrenzungen ==
Begrenzungen dienen im wesentlichen der Bandbreiten-Beschränkung. 
{{{<limits>
  <clients>4</clients> # Maximale Zuhörerzahl
  <sources>1</sources> # Maximale Anzahl gleichzeitig verbundener Quellen
  <threadpool>5</threadpool> # Anforderungen, die der Server gleichzeitig verarbeitet
  <queue-size>524288</queue-size> # Warteschlangengröße
  <client-timeout>30</client-timeout> # Verbindungstrennung bei Timeout zum Client in Sekunden
  <header-timeout>15</header-timeout> # Verbindungstrennung bei Timeout der Metadaten in Sekunden (?)
  <source-timeout>10</source-timeout> # Verbindungstrennung bei Timeout zum Source-Client in Sekunden
  <burst-on-connect>1</burst-on-connect> # Buffern bei Verbindung
  <burst-size>65535</burst-size> # Buffergröße
</limits>
}}}

== Benutzer und Passwörter ==
Damit nur die Moderatoren den Stream zum Server senden können, bedient man sich des Benutzers ``source``, dessen Zugriff ebenso passwortgeschützt ist wie der des Webadministrators. 
{{{<authentication>
 <source-password>hackme</source-password> # Passwort, mit dem sich der Benutzer source verbindet.
 <relay-password>hackme</relay-password> # Passwort, mit dem sich Relay-Server verbinden.
 <admin-user>admin</admin-user> # Der Benutzername des Administrators der Weboberfläche.
 <admin-password>hackme</admin-password> # Das Passwort des Administrators der Weboberfläche.
</authentication>
}}}

== Yellow Pages ==
Mit der Veröffentlichung der Metadaten zum Stream in den Yellow Pages wird die Internet-Station für die Hörer leicht auffindbar. 
{{{<directory>
 <yp-url-timeout>15</yp-url-timeout>
 <yp-url>http://dir.xiph.org/cgi-bin/yp-cgi</yp-url> # Beispiel Yellow Page Server
</directory>
}}}

== Server-Einstellungen ==

{{{<hostname>http://''deine.domain.de''</hostname> # Der Hostname ist der Computername des Systems oder seine IP-Adresse.

<listen-socket>
 <port>8000</port> # Der Port auf dem Moderator und Zuhörer zum Stream eines Mountpoints verbinden.
 <bind-address>::</bind-address> # Zugriff auch mit IPv6 ermöglichen. Fehlt dieser Eintrag, ist ein Zugriff nur via IPv4 möglich.
</listen-socket>
}}}

== Webserver ==
Der Webserver sorgt dafür, dass das Webinterface erreichbar ist. 
{{{<fileserve>1</fileserve> # Webserver an/aus
 <paths>
  <basedir>/usr/share/icecast2</basedir> # Basisverzeichnis für den Webserver
  <logdir>/var/log/icecast2</logdir> # Protokolldatei des Webservers
  <webroot>/usr/share/icecast2/web</webroot> # Wurzelverzeichnis des Webservers
  <adminroot>/usr/share/icecast2/admin</adminroot> # Wurzelverzeichnis des Webserver-Admins
  <alias source="/" dest="/status.xsl"/> # Alias für den Standard-Mountpoint
</paths>
}}}

== Logging und Sicherheit ==

{{{<logging>
 <accesslog>access.log</accesslog> # Name der Zugriffsprotokoll-Datei
 <errorlog>error.log</errorlog> # Name der Fehlerprotokoll-Datei
 <loglevel>4</loglevel> # 4 Debug, 3 Informationen, 2 Warnungen, 1 Fehler
 <logsize>10000</logsize> # Maximale Größe einer Protokoll-Datei
</logging>

<security>
 <chroot>0</chroot>
</security>
}}}
[[Anker(SourceClients)]] 
= Source-Clients =
Verschiedene Source-Clients stehen dem Moderator oder DJ des Icecast2-Servers zur Verfügung. Aus dem Icecast-Projekt selbst stammt Ices, das ohne grafische Oberfläche auskommt und in zwei verschiedenen Versionen entwickelt wird. Die Software Darkice kann wie Ices über Konfigurationsdateien eingestellt werden oder über die grafische Bedienoberfläche Darksnow. Für gehobene Ansprüche stellt die Internet DJ Console eine komfortable Lösung bereit, die jedoch ein solides System und die in [:Tonstudio/Konfiguration:] beschriebenen Einstellungen vorraussetzt. 
{{{#!vorlage Tabelle
<-4 tablestyle="width: 95%;" rowclass="titel">Source-Clients im Überblick
+++
<rowclass="kopf">Client
Input
Stream Format
Bedienoberfläche
+++
[:Darkice:]
ALSA, OSS, Abspielliste, jack
Ogg Vorbis, MP3, aac, MP2
[:Darkice: Darksnow]
+++
Ices0
ALSA, OSS, Abspielliste
MP3
-
+++
[:stream2ip:]
PulseAudio
Ogg Vorbis
integriert
+++
[:Mixxx:Mixxx - Digital DJ Interface] (ab Version 1.9.0)
DJ, Abspiellisten, jack, ALSA
Ogg Vorbis, MP3
integriert
+++
[:MPD:Music Player Daemon]
ALSA, OSS, jack, Abspiellisten, DJ
Ogg Vorbis, MP3
[:MPD:MPD-Clients]
+++
[:VLC:]
Abspielliste
Ogg Vorbis, MP3, aac, MP2
integriert
+++
}}}
[[Bild(./icecast-mit-vlc.png, 300 align=right)]]
== Nutzung mit VLC ==
Am einfachsten lässt sich Icecast2 mit VLC nutzen, dazu klickt man im Hauptfenster auf ''"Medien"'' und dann auf ''"Stream"''. In den folgenden Dialogen wählt man zuerst die gewünschte Tondatei und trägt dann im ''"Stream-Output"'' Dialog die Server-Adresse, sowie das Passwort und den Nutzernamen (Standard: source) ein. Nun sollte VLC sich mit dem Icecast Server verbinden und die Tondatei als Stream abspielen

= Start und Stopp-Befehle =
{{{#!vorlage Befehl
sudo systemctl start icecast2 # Icecast starten
sudo systemctl stop icecast2 # Icecast anhalten
sudo systemctl restart icecast2 # Icecast neu starten
}}}


= Links =
 * [https://www.icecast.org Icecast2] {en} - Projekt-Seite
 * [:Internetradio:] -Übersicht
 * [:Internetradio/Funktionsweise:] - Hintergrundwissen

# tag: Internet, Multimedia, Netzwerk, Server, Internetradio