RadioDJ streaming setup: from the playout PC to your listeners

A RadioDJ streaming setup sends the program's audio output into a separate encoder such as BUTT that connects to your Icecast or SHOUTcast server, while RadioDJ's Now Playing Info plugin writes each title to a file the encoder reads. RadioDJ v2 has no encoder of its own; the RadioDJ site lists an external encoder for versions after v1.8.2. Below: the chain, the values to copy, and the checks that prove the station is really on air.

Steps
8
Reviewed
Runs on
Radio
Written by
Get Stream Hosting

By the Get Stream Hosting team

Every step was checked against the software's official documentation by independent reviewers before publishing. Last reviewed .

Pre-flight check

The signal chain, end to end

Four links carry the programme from RadioDJ to a listener's phone. Each one has its own job, and most faults sit at a single link, so it helps to know them by name.

LinkWhat it doesWhere it is set
RadioDJPlays music, jingles and sweepers to a sound outputRadioDJ options and players
Audio routeCarries that output to an input the encoder can openA mixer loop or a virtual audio device
Encoder (BUTT)Compresses the audio and sends it to the server with the song titleBUTT settings: Main, Audio, Stream
Station serverTakes one source and serves it to every listenerYour radio control panel

The RadioDJ site describes the Shoutcast/Icecast encoder as a plugin in v1.8.2 and external for newer versions. If you still run v1.8.2 with its encoder plugin, the server fields below are the same; only the place you type them changes.

What to have ready

  • A Windows 10 or 11 PC. Those are the systems the RadioDJ site lists as supported; RadioDJ v2 needs .NET Framework 4.8.
  • RadioDJ installed with its database. RadioDJ keeps its library in a MySQL or MariaDB back-end; the RadioDJ tutorials cover installing the server.
  • BUTT from its official site. Builds exist for Windows, macOS and Linux; it streams MP3, AAC and three Ogg formats (Vorbis, Opus, FLAC).
  • Your station's encoder details: server address, port, source password and mountpoint (or stream ID for SHOUTcast). On our SSL radio streaming service they sit in the control panel.

Getting RadioDJ's sound into the encoder

BUTT cannot open RadioDJ directly. It records from an audio input, so RadioDJ's output has to arrive at one. There are two documented ways to do it.

  1. Through a mixer. The RadioDJ mixer tutorial sends RadioDJ's outputs to a hardware mixer and brings the mixer's main output back into the PC's line-in. Microphones join at the desk, and the line-in becomes the encoder's input. Keep the monitor or preview output on a separate channel so cueing never goes to air.
  2. Through a virtual device. The BUTT manual names Voicemeeter on Windows as a way to stream audio from another program. RadioDJ plays to the virtual device's input; BUTT records from its output.

In BUTT, open the Audio tab, press Update devices, and choose the line-in or virtual output as the primary device. Set channel mode to Stereo for music. Under Remember Device by, the manual recommends name rather than ID.

Do not point BUTT at a device that also carries Windows system sounds or your browser. Every notification chime would go out on air.

Settings to copy into BUTT

Open Settings, go to Main, and press ADD next to the server list. Copy each value exactly as your control panel shows it.

BUTT fieldIcecast stationSHOUTcast station
TypeIcecastSHOUTcast
AddressThe host name from your panel, no pathThe host name from your panel
PortThe source port from your panelThe source port from your panel
PasswordYour source passwordYour source password; only if the panel gives a user name or stream ID, enter user:password, adding :# and the stream ID
Icecast mountpointAs shown, for example /liveNot used
Icecast usersource unless your panel says otherwiseNot used
Use SSL/TLSOnly if your panel's encoder settings ask for itLeave off

Then pick the codec and bitrate in the Audio tab. MP3 is the plain choice. AAC needs one extra library on Windows; the BUTT manual explains where to put it. Keep the bitrate within what your plan carries: the service page lists 32 kbps on Free, 128 kbps on Premium and up to 320 kbps on Platinum.

Icecast's own documentation gives source as the user name that source connections use by default, which is why the field is usually left at that value.

Passing song titles from RadioDJ

Titles reach listeners through a text file. RadioDJ's Now Playing Info plugin writes the current track to it; BUTT watches the file and sends the new title to the server whenever the file changes.

  1. In RadioDJ, open the Now Playing Info plugin and go to the File Export tab.
  2. Choose a file in a folder your Windows user can write to. The plugin's tutorial warns against Program Files and the Windows folder.
  3. If you use a template file, keep its output to one line of artist and title. The variables it can use are listed in the stream variables document in RadioDJ's Docs folder.
  4. Set Text Encoding to match your character set, or the computer default if unsure, and tick Enable.
  5. In BUTT, open the Stream tab and set the song name to update from that same file. BUTT takes the first or the last line as the title.
  6. Play a track in RadioDJ and open the file in Notepad: it should show the track that is playing now.

The plugin's Custom Title tab replaces every title with fixed text, which is useful during a talk show with no music. Station name and description are set in BUTT's Main settings, and the manual notes they only change after you reconnect.

Checks before you go live

  1. Press play in BUTT. When it connects, the > symbol and the play button turn yellow. If they do not, BUTT keeps retrying until you stop it.
  2. Turn on Show listeners in BUTT's GUI settings. BUTT polls the count every 3 seconds and shows it in the lower right; the manual notes this usually works only with plain Icecast or SHOUTcast setups.
  3. Play the HTTPS listen link from your control panel in a browser on a phone. Sound should play, without a security warning.
  4. Let RadioDJ change track. The title in the player should follow it.
  5. Watch BUTT's level meter on the loudest track. Peaks that sit hard at the top will distort on air; lower RadioDJ's output or the input gain.

When it goes wrong

  • Play button never turns yellow. Check address, port and password character by character. For SHOUTcast, check that the password matches the panel, and use the user:password form only if the panel gives a user name or stream ID. If you ticked SSL/TLS, untick it unless your panel asks for it: the manual says the connection fails when the server does not support it.
  • Connected, but silence. BUTT is on the wrong input. Watch its meter while RadioDJ plays; if it does not move, choose another device and press Update devices.
  • Title stuck on one song. The plugin is not writing the file, or BUTT reads a different path. Open the file while tracks change.
  • Strange characters in titles. Match the plugin's Text Encoding to your character set.
  • Sound drops in bursts. Lower the bitrate, check the PC's upload, and close anything else using the connection.

Still stuck? Open a ticket or start a chat. Chat is open day and night, and you can ask for a person at any point.

Where your station runs

RadioDJ stays on your PC; the station server handles the listeners. Our SSL radio streaming serves every station over HTTPS, so the player plays on secure websites, and it accepts BUTT along with other Icecast and SHOUTcast sources. Stations start on Icecast, and one switch in the control panel moves them to SHOUTcast DNAS 2.6.

  • Free carries one live stream at 32 kbps. When the RadioDJ PC stops, the stream stops.
  • Premium adds AutoDJ (20 GB of music) plus a fallback playlist: if RadioDJ drops, music continues, and control returns to RadioDJ by itself once it is back.
  • Platinum allows up to 320 kbps and connects your encoder and your listeners to the nearest of five cities.

If you would rather not keep a PC switched on at all hours, paid plans let you upload your music so AutoDJ plays it around the clock. RadioDJ then becomes the live source for the hours you choose, and AutoDJ steps aside the moment it connects. Premium also brings your own station app; the app publishing guides walk through the stores.

Questions people ask

Can RadioDJ v2 send a stream without another program?

Not according to the RadioDJ site, which lists the Shoutcast/Icecast encoder as a plugin in v1.8.2 and external for newer versions. With v2 you run an encoder such as BUTT beside RadioDJ and route the audio into it.

Which encoders can I use with your radio hosting?

Any Icecast or SHOUTcast source works. BUTT, Mixxx, SAM Broadcaster, RadioBOSS and OBS (audio) are all known to connect. This guide uses BUTT because it is free and reads song titles from a file.

Which bitrate should RadioDJ's encoder use?

No higher than your plan carries: 32 kbps on Free, 128 kbps on Premium and up to 320 kbps on Platinum. Set the encoder to that figure or lower, and check that your PC's upload speed has room to spare.

Does the station keep playing when the RadioDJ computer is off?

On Free, no: the stream is live only, so it stops with the encoder. On Premium and Platinum, AutoDJ and the fallback playlist keep the station on air and step aside when your encoder connects again.

Why do listeners see the station name instead of the song?

The title is not reaching the encoder. Check that the Now Playing Info plugin's File Export is enabled, that BUTT points at the same file, and that the file changes when the track does.

Can I use SHOUTcast instead of Icecast?

Yes. In the control panel, one switch moves the station onto SHOUTcast DNAS 2.6, then set BUTT's server type to SHOUTcast and enter the source password from the panel; if the panel also gives a user name or stream ID, write it as user:password, with :# and the stream ID appended.

Radio

Put RadioDJ on air

Create a station, paste the panel's connection details into BUTT and work through the checks above. Begin on Free; upgrade once AutoDJ or a higher bitrate matters.