1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
|
<!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_miniplayers.html" id="tour-miniplayers-nav">Mini Players</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>
<li><a href="tutorials_jack_ports_demystified.html" id="tutorials-jackportsdemyst-nav">JACK Ports</a></li>
<li><a href="tutorials_secrets.html" id="tutorials-secrets-nav">Secrets</a></li>
</ul>
</li>
<li><a href="code.html" id="code-nav">Extra code</a></li>
<li>
<ul>
<li><a href="code_idjcmon.html" id="code-idjcmon-nav">idjcmon.py</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="https://shoutcast.com">https://shoutcast.com</a>.
</p>
<h4>Setting up Shoutcast</h4>
<p>Having downloaded the version of Shoutcast that's right for your platform and extracted it from
the archive you should locate the Shoutcast executable called sc_serv. This needs to be run with a suitable
confirguration file. There are some examples of these in the source tree as well as a configuration builder.
For the sake of simplicity a minimalist configuration will be used for this demonstration.
</p>
<p>Let's use a basic configuration file that we shall call sc_serv.conf which allows IDJC and listener clients to
connect to/from localhost merely for test purposes and contains the following text:</p>
<pre>
logfile=logs/sc_serv.log
w3clog=logs/sc_w3c.log
banfile=control/sc_serv.ban
ripfile=control/sc_serv.rip
password=changeme
adminpassword=protected
</pre>
<p>Let's run this with the following command.</p>
<pre>$ ./sc_serv sc_serv.conf</pre>
<p>Assuming you were not dumped back to a console prompt the server is now running.</p>
<h4>Configuring IDJC</h4>
<p>If not running Pipewire start the JACK sound server as follows in order to ensure unimpeded access to the soundcard by
Pulseaudio.</p>
<pre>$ jackd -d dummy -r 44100</pre>
<p>Run IDJC and select Output from the View menu. In the Output window 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 title="Obviously a server exposed to the Internet 
should never be configured to use its default password"><em>changeme</em></span>. Click Ok to add the server to the list.</p>
<p>Click Format. Select MPEG and click the right arrow repeatedly until all the option boxes appear.</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>
<p>If the connection fails try 127.0.0.1 in place of localhost.</p>
<h4>Streaming some audio</h4>
<p>Click the <em>+</em> button 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. Of the player's Audio Feed settings,
make sure Stream is on and DJ is off and Monitor Mix is set to DJ.
You should be able to see activity in the Str Peak meter.</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>
|
