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
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
|
<!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>
<li><a href="code_pipewire_appname.html" id="code-pipewire-appname-nav">pipewire patch</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 Icecast and IDJC', 'tutorials-icecast-nav')
</script>
<h4>Aims</h4>
<p>In this section I'm going to walk you through the procedure of setting up an Iceccast 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 an Icecast server for serious use. For that and other non IDJC related matters there are the
<a href="https://icecast.imux.net/">Icecast forums</a> and the Icecast documentation itself.</p>
<h4>Setting up Icecast</h4>
<h5>Why local?</h5>
<p>Everything in this tutorial will be demonstrated on the same machine and while not as impressive as
sending a stream half way across your house, by making this tutorial single machine specific I can
not only leave multi-machine as an exercise to the reader but also not have to worry about anyone's
local network specifics or how many machines they have reasonable access to.</p>
<h5>Installing Icecast</h5>
<ul><li>
<p>Ubuntu</p>
<pre class="reduced">sudo apt-get install icecast2</pre>
</li><li>
<p>Debian</p>
<pre class="reduced">sudo -c "apt-get install icecast2"</pre>
</li></ul>
<h5>The configuration file</h5>
<p>Take a look in your <em>/etc/icecast2/</em>
directory and you should find a file called <em>icecast.xml</em>. This file is and will be referred to as the
Icecast server configuration file. In it are the settings for the various different Icecast options.
Here below are the typical contents.</p>
<pre class="big-code" title="icecast.xml"><icecast>
<limits>
<clients>100</clients>
<sources>2</sources>
<threadpool>5</threadpool>
<queue-size>524288</queue-size>
<client-timeout>30</client-timeout>
<header-timeout>15</header-timeout>
<source-timeout>10</source-timeout>
<span style="color:gray;"><!-- If enabled, this will provide a burst of data when a client
first connects, thereby significantly reducing the startup
time for listeners that do substantial buffering. However,
it also significantly increases latency between the source
client and listening client. For low-latency setups, you
might want to disable this. --></span>
<burst-on-connect>1</burst-on-connect>
<span style="color:gray;"><!-- same as burst-on-connect, but this allows for being more
specific on how much to burst. Most people won't need to
change from the default 64k. Applies to all mountpoints --></span>
<burst-size>65535</burst-size>
</limits>
<authentication>
<span style="color:gray;"><!-- Sources log in with username 'source' --></span>
<source-password>hackme</source-password>
<span style="color:gray;"><!-- Relays log in username 'relay' --></span>
<relay-password>hackme</relay-password>
<span style="color:gray;"><!-- Admin logs in with the username given below --></span>
<admin-user>admin</admin-user>
<admin-password>hackme</admin-password>
</authentication>
<span style="color:gray;"><!-- set the mountpoint for a shoutcast source to use, the default if not
specified is /stream but you can change it here if an alternative is
wanted or an extension is required
<shoutcast-mount>/live.nsv</shoutcast-mount>
--></span>
<span style="color:gray;"><!-- Uncomment this if you want directory listings --></span>
<span style="color:gray;"><!--
<directory>
<yp-url-timeout>15</yp-url-timeout>
<yp-url>http://dir.xiph.org/cgi-bin/yp-cgi</yp-url>
</directory>
--></span>
<span style="color:gray;"><!-- This is the hostname other people will use to connect to your server.
It affects mainly the urls generated by Icecast for playlists and yp
listings. --></span>
<hostname>localhost</hostname>
<span style="color:gray;"><!-- You may have multiple <listener> elements --></span>
<listen-socket>
<port>8000</port>
<span style="color:gray;"><!-- <bind-address>127.0.0.1</bind-address> --></span>
<span style="color:gray;"><!-- <shoutcast-mount>/stream</shoutcast-mount> --></span>
</listen-socket>
<span style="color:gray;"><!--
<listen-socket>
<port>8001</port>
</listen-socket>
--></span>
<span style="color:gray;"><!--<master-server>127.0.0.1</master-server>--></span>
<span style="color:gray;"><!--<master-server-port>8001</master-server-port>--></span>
<span style="color:gray;"><!--<master-update-interval>120</master-update-interval>--></span>
<span style="color:gray;"><!--<master-password>hackme</master-password>--></span>
<span style="color:gray;"><!-- setting this makes all relays on-demand unless overridden, this is
useful for master relays which do not have <relay> definitions here.
The default is 0 --></span>
<span style="color:gray;"><!--<relays-on-demand>1</relays-on-demand>--></span>
<span style="color:gray;"><!--
<relay>
<server>127.0.0.1</server>
<port>8001</port>
<mount>/example.ogg</mount>
<local-mount>/different.ogg</local-mount>
<on-demand>0</on-demand>
<relay-shoutcast-metadata>0</relay-shoutcast-metadata>
</relay>
--></span>
<span style="color:gray;"><!-- Only define a <mount> section if you want to use advanced options,
like alternative usernames or passwords
<mount>
<mount-name>/example-complex.ogg</mount-name>
<username>othersource</username>
<password>hackmemore</password>
<max-listeners>1</max-listeners>
<dump-file>/tmp/dump-example1.ogg</dump-file>
<burst-size>65536</burst-size>
<fallback-mount>/example2.ogg</fallback-mount>
<fallback-override>1</fallback-override>
<fallback-when-full>1</fallback-when-full>
<intro>/example_intro.ogg</intro>
<hidden>1</hidden>
<no-yp>1</no-yp>
<authentication type="htpasswd">
<option name="filename" value="myauth"/>
<option name="allow_duplicate_users" value="0"/>
</authentication>
<on-connect>/home/icecast/bin/stream-start</on-connect>
<on-disconnect>/home/icecast/bin/stream-stop</on-disconnect>
</mount>
<mount>
<mount-name>/auth_example.ogg</mount-name>
<authentication type="url">
<option name="mount_add" value="http://myauthserver.net/notify_mount.php"/>
<option name="mount_remove" value="http://myauthserver.net/notify_mount.php"/>
<option name="listener_add" value="http://myauthserver.net/notify_listener.php"/>
<option name="listener_remove" value="http://myauthserver.net/notify_listener.php"/>
</authentication>
</mount>
--></span>
<fileserve>1</fileserve>
<paths>
<span style="color:gray;"><!-- basedir is only used if chroot is enabled --></span>
<basedir>/usr/share/icecast2</basedir>
<span style="color:gray;"><!-- Note that if <chroot> is turned on below, these paths must both
be relative to the new root, not the original root --></span>
<logdir>/var/log/icecast2</logdir>
<webroot>/usr/share/icecast2/web</webroot>
<adminroot>/usr/share/icecast2/admin</adminroot>
<span style="color:gray;"><!-- <pidfile>/usr/share/icecast2/icecast.pid</pidfile> --></span>
<span style="color:gray;"><!-- Aliases: treat requests for 'source' path as being for 'dest' path
May be made specific to a port or bound address using the "port"
and "bind-address" attributes.
--></span>
<span style="color:gray;"><!--
<alias source="/foo" dest="/bar"/>
--></span>
<span style="color:gray;"><!-- Aliases: can also be used for simple redirections as well,
this example will redirect all requests for http://server:port/ to
the status page
--></span>
<alias source="/" dest="/status.xsl"/>
</paths>
<logging>
<accesslog>access.log</accesslog>
<errorlog>error.log</errorlog>
<span style="color:gray;"><!-- <playlistlog>playlist.log</playlistlog> --></span>
<loglevel>3</loglevel> <span style="color:gray;"><!-- 4 Debug, 3 Info, 2 Warn, 1 Error --></span>
<logsize>10000</logsize> <span style="color:gray;"><!-- Max size of a logfile --></span>
<span style="color:gray;"><!-- If logarchive is enabled (1), then when logsize is reached
the logfile will be moved to [error|access|playlist].log.DATESTAMP,
otherwise it will be moved to [error|access|playlist].log.old.
Default is non-archive mode (i.e. overwrite)
--></span>
<span style="color:gray;"><!-- <logarchive>1</logarchive> --></span>
</logging>
<security>
<chroot>0</chroot>
<span style="color:gray;"><!--
<changeowner>
<user>nobody</user>
<group>nogroup</group>
</changeowner>
--></span>
</security>
</icecast></pre>
<p>What we should do now is copy and paste this file into a text editor or start editing a copy of your original
file. Hint: use your own file in preference to mine. Launch a text editor like gedit to do this.</p>
<p>Next, select Save As in the text editor's menu, choose the file name icecast.xml, and save it in your home directory.</p>
<h5>Attempting to run</h5>
<pre>$ icecast2 -c icecast.xml
FATAL: could not open error logging (/var/log/icecast2/error.log): No such file or directory
FATAL: could not open access logging (/var/log/icecast2/access.log): No such file or directory
FATAL: Could not start logging
</pre>
<p>Fix this by editing icecast.xml and change the logdir setting to /tmp which will solve the problem of
inadequate write permissions and try again. Leave Icecast running for the time being.</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 Icecast 2 Master, for Hostname, localhost, port number should be 8000, mount point
can be what you like but choose /listen, login name needs to be source 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>hackme</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 Icecast configuration file.</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</body>
</html>
|
