Log-Level¶

• 1 - Nur Fehlermeldungen werden geloggt

• 2 - Obige und Warnmeldungen werden geloggt

• 3 - Obige und Informationsmeldungen werden geloggt

• 4 - Obige und Debugmeldungen werden geloggt

hostname¶

Setzt den hostname des Icecast-Servers, der kontaktiert wird. Dies kann ein Name oder eine IP-Adresse (ipv4 oder ipv6 auf Systemen, die ipv6 unterstützen) sein. Die Voreinstellung ist localhost.

port¶

Setzt den Port, auf dem der Icecast-Server kontaktiert wird. Normalerweise 8000, kann aber in Abstimmung mit dem Server beliebig gewählt werden.

password¶

Zum Bereitstellen des Streams werden der Benutzername des Benutzers source und dessen Passwort für den Icecast-Server benötigt. Im Icecast2-Server sind dies beispielsweise source und hackme.

mount¶

Mountpoints (Einbindepunkte) werden verwendet, um einen einzelnen Stream auf einem Icecast-Server zu identifizieren. Sie müssen mit einem / beginnen und sollten mit .ogg enden.

yp¶

Streams werden nicht in den Yellow Pages gelistet, außer yp ist ausdrücklich eingestellt (Wert ist 1). In den Yellow Pages werden Internetradio-Stationen mit Name, Beschreibung, Genre und laufendem Titel geführt, damit Zuhörer diese finden können (beispielsweise auf dir.xiph.org 🇬🇧).

Resample¶

1
2
3
4

<resample>
 <in-rate>44100</in-rate>
 <out-rate>22050</out-rate>
</resample>

Beim Encodieren oder Re-Encodieren kommt ein Punkt, an dem PCM-Audiodaten als Ogg/Vorbis encodiert werden. In manchen Situationen verlangt ein bestimmter Stream vielleicht eine niedrigere Samplerate, um eine niedrigere Bitrate zu erreichen. Die Resample-Funktion verändert die Audiodaten, bevor sie den Encoder durchlaufen.

Die gängigsten Einstellungen sind 48000, 44100, 22050 und 11025, und es ist wirklich nur brauchbar, um eine niedrigere Samplerate zu erreichen. Die Samplerate mit IceS zu erhöhen ist nicht möglich.

Downmix¶

Einige Streams wollen ihre Bitrate noch weiter absenken, dazu wird die Anzahl der verwendeten Kanäle auf einen beschränkt. Die Umwandlung von Stereo in Mono ist allgemein üblich und wenn hier 1 eingestellt ist, werden die vorhandenen Kanäle zu einem Kanal (Mono) zusammengemischt. Wie bei der Resample-Funktion betrifft dies nur die Instanz, zu der es notiert ist.

Savefile¶

Manchmal soll der gesendete Stream auch gleich auf die Festplatte gespeichert werden. Nützlich ist dies vor allem bei Live-Aufnahmen. Dazu muss hier nur der Pfad angegeben werden, wo der Stream abgespeichert werden soll.

encode¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

<encode>  
 <quality>0</quality>
 <nominal-bitrate>65536</nominal-bitrate>
 <maximum-bitrate>131072</maximum-bitrate>
 <minimum-bitrate>-1</minimum-bitrate>
 <managed>0</managed>
 <samplerate>22050</samplerate>
 <channels>1</channels>
 <flush-samples>11000</flush-samples>
</encode>

Basic¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

<!-- eine Playlist in einfachem Textformat -->
<param name="type">basic</param>
<!-- Speicherort der Playlist -->
 <param name="file">/pfad/zur/playlist</param>
<!-- Abspielreihenfolge der Playlist zufällig ändern -->
 <param name="random">0</param>
<!-- auf 1 gesetzt, beendet dies IceS nach dem einmaligen Durchlaufen der Playlist -->
 <param name="once">0</param>
<!-- Playlist nach Update von vorne beginnen -->
 <param name="restart-after-reread">1</param>

Beispielhafte Abspielliste im einfachen Textformat:

/pfad/datei_1.ogg
/pfad/datei_2.ogg
/pfad/datei_n.ogg

Skript¶

Ein Skript oder Programm, das den Speicherort einer OggVorbis-Datei ausgibt:

1
2
3

<param name="type">script</param>
<!-- Speicherort des Skripts -->
 <param name="program">/path/to/program</param>