BUTT broadcast setup: get your station on air from a laptop

To broadcast with BUTT, you add your station's server in its settings (address, port, password, and for Icecast a mountpoint), choose your microphone or mixer as the audio input, set a codec and a bitrate your plan allows, then press the play button. By the end of this guide your voice will reach a listen link anyone can open on a phone, and the player will show what is playing.

By the Stream Brothers team

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

Before you start

Running order
  1. What BUTT does, and what it does not
  2. Gather these four things first
  3. Install BUTT on your computer
  4. Add your station's server
  5. Choose your audio input, codec and bitrate
  6. Name your station and show the song playing
  7. Going live, and what you should see
  8. When it will not connect
  9. Your questions

What BUTT does, and what it does not

BUTT (short for Broadcast Using This Tool) is a small, free program that takes the sound coming into your computer, from a microphone, a USB mixer or a line input, and sends it live to a radio server. It can also save a recording of the show on your computer while you broadcast.

It is an encoder: the piece that squeezes live sound into a stream the server can pass on to listeners. It is not a music player. Its author is clear that it does not stream audio files directly, so if you want songs between your talk, you either play them through your mixer, or route a music player's sound into BUTT with an audio routing tool such as Voicemeeter on Windows or BlackHole on macOS.

If what you want is music playing by itself all day and night, BUTT is the wrong tool for that part. On our radio hosting plans, Pro and Platinum include AutoDJ, which plays your uploaded music whenever nobody is live and hands over to your BUTT show when you connect.

Gather these four things first

  • A radio station on a server. Icecast or SHOUTcast both work with BUTT. Every Stream Brothers station, the free plan included, accepts one live stream from any Icecast or SHOUTcast encoder.
  • Your encoder details: the server address, the port, the password and, for Icecast, the mountpoint (the part of the stream address after the slash, which names your stream). You will find them with your station in your control panel.
  • A sound source. A USB microphone works on its own; a mixer lets you blend a microphone and music. Our home studio guide covers what to buy first.
  • A steady upload. Your stream leaves your home over your upload, so check it before the first show with our upload speed guide.

Install BUTT on your computer

Download BUTT from its author's own website (linked in the sources below), not a download portal, then follow the line for your system.

  • Windows: run the setup file and follow the installer. It does not need administrator rights, so it may suggest an install folder you do not expect; that is normal.
  • macOS: open the .dmg file and drag BUTT into your Applications folder.
  • Linux: the author's site offers a ready-made AppImage; to build from source instead, install the libraries the manual lists, then run ./configure, make and sudo make install in the unpacked folder. On distributions without libfdk-aac, such as Debian, it says to use ./configure --disable-aac instead.

AAC is an optional add-on. The other codecs work straight away, so you can skip it unless you have a reason to want AAC.

Add your station's server

This step decides whether you go on air, so copy each value exactly from your control panel.

  1. Open BUTT and click the settings button to open the settings window.
  2. In the server area, click ADD. A form opens.
  3. Give the server a name you will recognise, such as the station's name.
  4. Choose the type your station uses: Icecast or Shoutcast.
  5. Type the server address and the port exactly as your encoder settings show them.
  6. For Icecast: enter the password, the mountpoint, and the user. Icecast's own documentation says the default user name for source connections is source, but use whatever your encoder settings give you.
  7. For Shoutcast: enter the password only. If your settings give you a user and a stream ID (SID) as well, they all go in the password box, joined like this: MyUser:MyPassword:#1, with your own values in place of these.
  8. Leave Use SSL/TLS unticked unless your encoder settings say the server accepts a secure source connection. The option exists for Icecast only.
  9. Click ADD in the lower-right corner of the form, then click Save in the settings window so BUTT remembers it next time.

Treat the source password like a house key: anyone who has it can broadcast on your station. Do not paste it into chats or screenshots, and give each guest presenter their own DJ account (Pro and Platinum have them) rather than your main password.

Choose your audio input, codec and bitrate

In the Audio tab you pick the sound card BUTT listens to and the sample rate. Choose your USB microphone or mixer by its name; the manual recommends having BUTT remember the device by name rather than by number, so it still finds it after you plug things in a different order. Click Update devices if yours is missing.

Next comes the codec, the format your sound is packed into. For streaming, BUTT offers mp3, aac+, ogg/vorbis, ogg/opus and ogg/FLAC. Then the bitrate: how much data per second the stream uses. Higher sounds better but needs more upload and more data on your listeners' phones. Set it no higher than your plan's highest bitrate, which the plan comparison lists.

Stream Brothers radio planHighest bitrateListeners at once
Free32 kbps1,000
Pro128 kbps2,500
Platinumup to 320 kbps5,000

The channel mode setting chooses stereo or mono. A mono stream spends its whole bitrate on one channel, which suits a talk show with a single microphone, especially at a low bitrate. Watch the level meter in the main window as you speak; it shows your volume in dBFS, and if it sits hard against the top, lower the gain on your mixer or with BUTT's gain slider.

Name your station and show the song playing

Under Stream infos in the Main settings you can fill in details such as your genre, a short description and your web address, which BUTT hands to the server along with your stream. These are sent when BUTT connects, so changing them needs a reconnect.

The song title is a separate thing, set from the Stream tab, and BUTT can update it four ways:

  • By hand: type into Song Name and press Enter or click OK.
  • From a text file: point BUTT at a file whose first or last line holds the current song. When the file changes, BUTT sends the new title.
  • From a web address: enter it under Update song name from URL, tick Activate and set the Update interval in seconds. BUTT uses only the first line of the reply and does not strip HTML from it.
  • From a music app: on Linux and macOS, BUTT can read the title from some players, such as Spotify or Apple's Music app. This is not available on Windows.

BUTT can also delay title updates so they line up with what listeners actually hear.

Going live, and what you should see

  1. Press the play button in BUTT's main window.
  2. The display changes from idle to streaming, and the connection indicator lights up. Click the display to cycle through how long you have been on air and how much data has been sent.
  3. Open your station's listen link on a phone, using mobile data rather than your home Wi-Fi, and listen for your own voice a few seconds late.
  4. When the show ends, press stop.

If your connection drops mid-show, BUTT keeps trying to reconnect until you press stop, so a short internet hiccup usually fixes itself. To keep a copy of every show, use the record button, or turn on start recording when connected so you never forget.

When it will not connect

  • Check the type first. An Icecast server set up as Shoutcast in BUTT, or the other way round, will refuse you. Our stations start on Icecast, and a switch in your control panel can move one to SHOUTcast, so match whichever is set today.
  • Copy, do not retype. A wrong port, a missing slash or an extra space in the password is the usual cause.
  • Shoutcast with a user or SID: remember both go inside the password box, separated by colons.
  • Silence on the listen link while BUTT says it is connected: the wrong audio device is selected. Speak and watch the meter; if it does not move, pick another input in the Audio tab.
  • BUTT will not even open after a settings mix-up: first copy your settings file somewhere safe (buttrc in your AppData\Roaming folder on Windows, ~/.buttrc on macOS and Linux), then hold Shift while BUTT starts to create a fresh one, and add your server again.

Still stuck? Open a ticket and say which server type you picked and what BUTT's log window shows.

Put your station on air

Start a free station that takes a live stream from BUTT, with an HTTPS listen link and an embeddable player, and move up to AutoDJ when you are ready.

Your questions

Is BUTT free to use?

Yes. BUTT is free software from an independent developer, available for Windows, macOS and Linux. Its author accepts donations, but nothing in the program is locked behind them.

Can BUTT play my music library on its own?

No. BUTT sends whatever sound reaches your sound card; it does not open music files itself. Play songs through your mixer or route a music player into BUTT with a routing tool. For music that runs without you, a plan with AutoDJ does that job on the server.

Which codec should a beginner pick?

BUTT streams mp3, aac+, ogg/vorbis, ogg/opus and ogg/FLAC. If your encoder settings name a format, use that one. Either way, test the listen link on a phone and in a desktop browser before the first show, and keep the bitrate within your plan.

My SHOUTcast settings include a stream ID. Where does it go?

In the password box. BUTT expects the user, the password and the stream ID joined with colons, with a # before the ID, for example MyUser:MyPassword:#1. BUTT speaks the older SHOUTcast protocol, which newer SHOUTcast servers accept by default.

Can several presenters use BUTT on one station?

Yes, one at a time. On Pro you can have up to 5 DJ accounts and on Platinum 20, each limited to its own slots, so every presenter connects with their own login instead of sharing the main password.

Do I need BUTT at all?

Not always. Pro and Platinum stations can broadcast straight from a browser tab, with a studio encoder that adds sound processing. BUTT is the better fit when you want a desktop program, your own recordings, or the free plan.