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.
| Link | What it does | Where it is set |
|---|---|---|
| RadioDJ | Plays music, jingles and sweepers to a sound output | RadioDJ options and players |
| Audio route | Carries that output to an input the encoder can open | A mixer loop or a virtual audio device |
| Encoder (BUTT) | Compresses the audio and sends it to the server with the song title | BUTT settings: Main, Audio, Stream |
| Station server | Takes one source and serves it to every listener | Your 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.
- 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.
- 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 field | Icecast station | SHOUTcast station |
|---|---|---|
| Type | Icecast | SHOUTcast |
| Address | The host name from your panel, no path | The host name from your panel |
| Port | The source port from your panel | The source port from your panel |
| Password | Your source password | Your source password; only if the panel gives a user name or stream ID, enter user:password, adding :# and the stream ID |
| Icecast mountpoint | As shown, for example /live | Not used |
| Icecast user | source unless your panel says otherwise | Not used |
| Use SSL/TLS | Only if your panel's encoder settings ask for it | Leave 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.
- In RadioDJ, open the Now Playing Info plugin and go to the File Export tab.
- Choose a file in a folder your Windows user can write to. The plugin's tutorial warns against Program Files and the Windows folder.
- 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.
- Set Text Encoding to match your character set, or the computer default if unsure, and tick Enable.
- 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.
- 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
- 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.
- 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.
- Play the HTTPS listen link from your control panel in a browser on a phone. Sound should play, without a security warning.
- Let RadioDJ change track. The title in the player should follow it.
- 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:passwordform 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.