Martin.leese: Added Category:Icecast

2015-12-24T20:12:18Z

← Older revision		Revision as of 20:12, 24 December 2015
Line 57:		Line 57:
	: '''I.)''' To stop ices2 we can send it a '''SIGTERM''' with '''killall''' to terminate it in a friendly manner.		: '''I.)''' To stop ices2 we can send it a '''SIGTERM''' with '''killall''' to terminate it in a friendly manner.
	<nowiki>$ killall ices2</nowiki>		<nowiki>$ killall ices2</nowiki>

			[[Category:Icecast]]

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

2015-12-24T06:25:48Z

How to install, configure, and run Ices2 on Debian 8

New page

== 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>

IceS/Getting Started - Revision history

Martin.leese: Added Category:Icecast

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