<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="content-type" content="text/html;charset=utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta name="description" content="Internet DJ Console (IDJC) is a Shoutcast/Icecast internet radio client incorporating features for live radio show production." />
<meta name="keywords" xml:lang="en" content="idjc dj shoutcast icecast radio linux gtk live recorded voip irc" />
<link rel="shortcut icon" href="favicon.png" type="application/png" />
<link rel="stylesheet" href="style.css" type="text/css" />
<!--[if lte IE 7]><link rel="stylesheet" href="style_ie.css" type="text/css" /><![endif]-->
<title>Internet DJ Console Homepage</title>
<script type="text/javascript">
// Change the title text and highlight a navigation bar option.
function ui(title, menu) {
document.getElementById('title').innerHTML = title;
s = document.getElementById(menu).style;
s.color = "#F70";
s.fontWeight = "bold";
s.textDecoration = "underline";
}
</script>
</head>
<body>
<!-- Hidden h1 title for search engine seeding -->
<h1 class="unshown">Internet DJ Console Homepage IDJC</h1>
<table id="main-table">
<tr><td>
<table>
<tr id="logo-holder">
<td>
<img src="site-logo.png" width="148" height="212" alt="website logo" title="Internet DJ Console homepage"/>
</td>
</tr>
<tr>
<td id="left-sidebar">
<h3>Contents</h3>
<ul id="sidebar-menu">
<li><a href="index.html" id="front-page-nav">Front page</a></li>
<li><a href="tour.html" id="tour-nav">Tour</a></li>
<li>
<ul>
<li><a href="tour_main.html" id="tour-main-nav">Main window</a></li>
<li><a href="tour_jingles.html" id="tour-jingles-nav">Jingles</a></li>
<li><a href="tour_output.html" id="tour-output-nav">Output</a></li>
<li><a href="tour_preferences.html" id="tour-preferences-nav">Preferences</a></li>
</ul>
</li>
<li><a href="install.html" id="install-nav">Installation</a></li>
<li>
<ul>
<li><a href="install_standard.html" id="install-standard-nav">Standard</a></li>
<li><a href="install_build.html" id="install-build-nav">Building</a></li>
<li><a href="install_first_run.html" id="install-first-run-nav">First run</a></li>
</ul>
</li>
<li><a href="tutorials.html" id="tutorials-nav">Tutorials</a></li>
<li>
<ul>
<li><a href="tutorials_icecast.html" id="tutorials-icecast-nav">Icecast</a></li>
<li><a href="tutorials_shoutcast.html" id="tutorials-shoutcast-nav">Shoutcast</a></li>
<li><a href="tutorials_voip.html" id="tutorials-voip-nav">VoIP</a></li>
</ul>
</li>
<li><a href="contact.html" id="contact-nav">Contact</a></li>
</ul>
</td>
</tr>
</table>
</td>
<td>
<table id="right-table">
<tr>
<td id="top-titlebar">
<h2 id="title"></h2>
</td>
</tr>
<tr>
<td>
<script type="text/javascript">
ui('Tutorials: Streaming with Shoutcast and IDJC', 'tutorials-shoutcast-nav')
</script>
<h4>Aims</h4>
<p>In this section I'm going to walk you through the procedure of setting up a Shoutcast server
and then sending a live stream to it with IDJC. In addition I will demonstrate the connection of
a listener to show that everything really does work.</p>
<p>The advice below is for demonstration purposes only. Not covered are best practices of locking
down a Shoutcast server for serious use. There are plenty of specialized Shoutcast hosting services
to take that burden, for a price.</p>
<h4>Obtaining Shoutcast</h4>
<p>Shoutcast may not be available in your Linux distribution. Not really a problem since it's available
as a presumably statically linked binary from <a href="http://www.shoutcast.com">http://www.shoutcast.com</a>.
It's important that you avoid version 2 because IDJC does not support it yet.
</p>
<h4>Setting up Shoutcast</h4>
<p>Okay, so having downloaded the version of Shoutcast that's right for your platform and extracted it from
the archive there should be two files called sc_serv and sc_serv.conf. The first is the server and the
second is its configuration file. There is also a README.TXT which contains some recommended reading.</p>
<p>Let's run this and see what success looks like.</p>
<pre>$ ./sc_serv sc_serv.conf
*******************************************************************************
** SHOUTcast Distributed Network Audio Server
** Copyright (C) 1998-2004 Nullsoft, Inc. All Rights Reserved.
** Use "sc_serv filename.ini" to specify an ini file.
*******************************************************************************
Event log:
<10/05/10@07:09:16> [SHOUTcast] DNAS/Linux v1.9.8 (Feb 28 2007) starting up...
<10/05/10@07:09:16> [main] pid: 5755
<10/05/10@07:09:16> [main] loaded config from sc_serv.conf
<10/05/10@07:09:16> [main] initializing (usermax:32 portbase:8000)...
<10/05/10@07:09:16> [main] No ban file found (sc_serv.ban)
<10/05/10@07:09:16> [main] No rip file found (sc_serv.rip)
<10/05/10@07:09:16> [main] opening source socket
<10/05/10@07:09:16> [main] source thread starting
<10/05/10@07:09:16> [main] opening client socket
<10/05/10@07:09:16> [source] listening for connection on port 8001
<10/05/10@07:09:16> [main] Client Stream thread [0] starting
<10/05/10@07:09:16> [main] client main thread starting</pre>
<h4>Configuring IDJC</h4>
<p>Start the Jack sound server as follows.</p>
<pre>$ jackd -d dummy -r 44100</pre>
<p>This is done so that any media player, even one that does not support Jack Audio Connection Kit can be
used for playing the stream on this machine.</p>
<p>Run IDJC and click the Output button in the bottom left hand corner. Click Configuration so the
configuration section is visible.</p>
<p>Click Connection, then New.</p>
<p>For Server type you want Shoutcast Master, for Hostname, localhost, port number should be 8000 and the password
will be the default password, which is <span style="color:red;" title="Obviously a server exposed to the Internet 
should never be configured to use its default password">changeme</span>. Click Ok to add the server to the list.</p>
<p>Click Format. Select the Sample rate drop down box and choose 44100. Select MP3 and the top drop down box.
Choose 128, Quality 5, and Joint Stereo. </p>
<p>Click Individual Controls so the controls section is visible and click the button that says
localhost:8000/listen.</p>
<p>If the button stays in you have made the connection.</p>
<h4>Streaming some audio</h4>
<p>Click the down pointing arrow on the left media player and using the file selector add a track to the
playlist. Click play. Make sure the crossfader is set all the way to the left. Make sure Stream is on and DJ is off.
You should be able to see the Str Peak meter is active.</p>
<p>If you can't hear anything right now it's because DJ is off and/or you are running a dummy Jack soundcard,
which is what you want for the sake of this test.</p>
<h4>Join the stream as a listener</h4>
<pre>$ mplayer http://localhost:8000/listen</pre>
<p>After a brief moment audio should start to play and within thirty seconds the listener count in the main IDJC
window should have risen to 1. It's possible to add more listeners up to the maximum number currently
specified in the Shoutcast configuration file.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</body>
</html>
