Internet DJ Console Homepage IDJC

website logo

Aims

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.

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.

Obtaining Shoutcast

Shoutcast may not be available in your Linux distribution. Not really a problem since it's available as a presumably statically linked binary from https://shoutcast.com.

Setting up Shoutcast

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.

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:

logfile=logs/sc_serv.log
w3clog=logs/sc_w3c.log
banfile=control/sc_serv.ban
ripfile=control/sc_serv.rip
password=changeme
adminpassword=protected

Let's run this with the following command.

$ ./sc_serv sc_serv.conf

Assuming you were not dumped back to a console prompt the server is now running.

Configuring IDJC

If not running Pipewire start the JACK sound server as follows in order to ensure unimpeded access to the soundcard by Pulseaudio.

$ jackd -d dummy -r 44100

Run IDJC and select Output from the View menu. In the Output window click Configuration so the configuration section is visible.

Click Connection, then New.

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 changeme. Click Ok to add the server to the list.

Click Format. Select MPEG and click the right arrow repeatedly until all the option boxes appear.

Click Individual Controls so the controls section is visible and click the button that says localhost:8000/listen.

If the button stays in you have made the connection.

If the connection fails try 127.0.0.1 in place of localhost.

Streaming some audio

Click the + 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.

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.

Join the stream as a listener

$ mplayer http://localhost:8000/listen

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.