IceS/Getting Started

2015-12-24T06:25:48Z

Goat avenger: How to install, configure, and run Ices2 on Debian 8

== Debian 8 Quick Start Guide ==
=== Installing Ices2 ===
: '''I.)''' Open a terminal and operate from the root user.
:: '''A.)''' '''su''' to root or skip this step and use '''sudo''' if available.
<nowiki>$ su</nowiki>
: '''II.)''' Install Ices2 with '''apt-get'''
:: '''A.)''' Use '''apt-get''' or '''sudo apt-get'''
<nowiki>$ apt-get install ices2</nowiki>
OR
<nowiki>$ sudo apt-get isntall ices2</nowiki>
=== Configuring Ices2 ===
: '''I.)''' Create an Ices2 config file.
:: '''A.)''' Navigate to '''/usr/share/doc/ices2/examples''' for some example configuration files to run Ices2 with.
<nowiki>$ cd /usr/share/doc/ices2/examples</nowiki>
:: '''B.)''' Copy an appropriate example configuration file to an appropriate directory
<nowiki>$ cp ices-playlist.xml /home/SOME_USER/.ices2/ices-playlist_v00.xml</nowiki>
:: '''C.)''' Edit some of the basics within the configuration file using '''nano''' or a graphical text editor of your choice.
<nowiki>$ nano /home/SOME_USER/.ices2/ices-playlist_v00.xml</nowiki>
: '''II.)''' Configuration, suggestions, and tips for your configuration file.
:: '''A.)''' Tell Ices2 to run in the background when executed.
<nowiki><background>1</background></nowiki>
:: '''B.)''' Name your stream, define some genres, and give a brief description of it.
<nowiki>
<metadata>
<name>Example stream name</name>
<genre>Example genre</genre>
<description>A short description of your stream</description>
</metadata></nowiki>
:: '''C.)''' Create and add a playlist to be used.
::: '''1.)''' Use '''find''', '''pwd''', and '''grep''' together to pipe out the file contents of your music directory folder to create a playlist.
:::: '''a.)''' For example, create a directory and fill it with the music you would like to create
<nowiki>$ mkdir /home/SOME_USER/Music/Streams/Stream-00</nowiki>
:::: '''b.)''' Fill that directory with some music files. For example, say you copy over an album composed of .ogg files.
<nowiki>$ cp -r /home/SOME_USER/Music/My_Music_Collection/John_Grisham/Grishams_Greatest_Hits /home/SOME_USER/Music/Streams/Stream-00</nowiki>
:::: '''c.)''' Navigate to your stream's music directory and create a playlist.
<nowiki>$ cd /home/SOME_USER/Music/Streams/Stream-00
$ find $(pwd) -type f | grep .ogg > Stream-00_Playlist.txt</nowiki>
:::: '''d.)''' You can now open the new playlist file and check to make sure everything checks out.
<nowiki>$ nano Stream-00_Playlist.txt</nowiki>
::: '''2.)''' Add the playlist to the configuration file.
<nowiki><param name="file">/home/SOME_USER/Music/Streams/Stream-00/Stream-00_Playlist.txt</param></nowiki>
::: '''3.)''' Tell Ices2 to randomly play selected files from the playlist (shuffle).
<nowiki><param name="random">1</param></nowiki>
:: '''D.)''' At this point Ices2 should be ready to roll. However, there are a few more settings you will want to change. Refer to [http://icecast.org/ices/docs/ices-2.0.2/config.html the ices docs] for more detailed configuration.
::: '''1.)''' Assuming Ices2 is running on the same machine as Icecast2 make sure the '''hostname''' and '''port''' match that of the '''icecast.xml''' configuration file for Icecast2
<nowiki>
<hostname>localhost</hostname>
<port>8000</port></nowiki>
::: '''2.)''' Change the password to match the source password configured in the '''icecast.xml''' configuration file and change the default mountpoint.
<nowiki>
<password>something_other_than-hackme</password>
<mount>/John_Grisham.ogg</mount></nowiki>
=== Start Ices2 ===
: '''I.)''' Start Ices2!
<nowiki>$ ices2 /home/SOME_USER/.ices2/ices-playlist_v00.xml</nowiki>
=== Stop Ices2 ===
: '''I.)''' To stop ices2 we can send it a '''SIGTERM''' with '''killall''' to terminate it in a friendly manner.
<nowiki>$ killall ices2</nowiki>

Icecast Server

2015-12-24T03:54:39Z

Goat avenger: /* External Links */

[[File:Icecast_Logo.svg|100px|left]]
Icecast is a streaming media server which currently supports [[Ogg]] ([[Vorbis]] and [[Theora]]), [[Opus]] and WebM streams.<br />
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.<br />
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 Unofficial(?) 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__

XiphWiki - User contributions [en]

IceS/Getting Started

Icecast Server