Stream OBS audio to an Icecast mount with the custom FFmpeg output

To stream from OBS to Icecast, switch OBS to the Advanced output mode, set the Recording type to Custom Output (FFmpeg), choose Output to URL, and enter an address of the form icecast://user:password@host:port/mount with an MP3 container and the libmp3lame audio encoder. Pressing Start Recording then sends the audio to your mount. This guide lists every field, the checks to run before the show, and what to look at when it refuses to connect.

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

OBS Studio has no Icecast entry in its Stream settings. The route runs through the recording side instead: the Custom Output (FFmpeg) recording type can write to a network address rather than a file, and FFmpeg understands the icecast:// scheme. The OBS project's own wiki describes this same Record-output method for other network protocols.

  1. Your microphone, music and desktop audio are mixed in OBS as usual.
  2. The Record output encodes that mix with FFmpeg, for example to MP3.
  3. FFmpeg opens a source connection to the Icecast server and mounts the stream at the path you give it.
  4. Listeners play the mount through the station's listen link.

Because the Record output carries the broadcast, you cannot make a local recording in the same OBS profile while it is on air. Record a backup copy somewhere else in the chain if you need one.

What to collect before you open OBS

You need five details from your Icecast server. On our SSL radio streaming service they come with your station's encoder settings; Platinum stations find them in the control panel's Radio section.

DetailWhat it isNotes
HostThe server name your encoder connects toOn Platinum, use the nearest-server encoder address from the Radio section
PortThe port the server listens on for sourcesCopy it; do not assume a default
MountThe path that names your stream, starting with a slashAvoid spaces and unusual characters; copy it exactly
Source userIcecast's default source username is sourceUse the one your panel gives if it differs
Source passwordThe password for encodersNot your control panel login

Then note the bitrate your plan carries. The service page lists 32 kbps on Free, 128 kbps on Premium and up to 320 kbps on Platinum. Set OBS to that figure or lower.

Settings to copy into OBS

  1. Open Settings, then Output, and set Output Mode to Advanced.
  2. Open the Recording tab and set Type to Custom Output (FFmpeg).
  3. Set FFmpeg Output Type to Output to URL.
  4. In File path or URL, enter your address in the form shown below.
  5. Set Container Format to mp3.
  6. Set Audio Encoder to libmp3lame and the Audio Bitrate to your plan's figure or lower. Tick the audio track that carries your programme mix.
  7. Click Apply, then OK. Press Start Recording to go on air and Stop Recording to leave.
icecast://source:YOUR-SOURCE-PASSWORD@your-server.example:PORT/your-mount

That layout follows FFmpeg's protocol documentation: icecast://[username[:password]@]server:port/mountpoint. If the password contains characters such as @, : or /, the address can be misread; use a source password made of letters and digits only.

The password sits in plain view in that field and in your OBS profile. Do not share screenshots of the Output settings or hand your profile folder to anyone, and change the source password if either has leaked.

Why MP3, and when to choose Ogg

FFmpeg's Icecast protocol announces the stream as audio/mpeg unless told otherwise, and its documentation says the content type must be set whenever the stream is something else. An MP3 container with libmp3lame matches that default, so no extra option is needed.

Icecast's own FAQ lists Ogg (Vorbis), Opus, FLAC and WebM as its officially supported formats and says MP3 and AAC may work without official support. For a hosted station, MP3 is the safe default unless your provider says otherwise. On a self-managed Icecast server with Ogg Vorbis, its basic setup guide asks for a mount ending in .ogg, and FFmpeg needs content_type set to match.

Checks before you go live

  • OBS status bar shows the recording timer running, and it keeps running past the first minute.
  • The audio meter for the track you ticked moves when you speak.
  • On a second device, open the HTTPS listen link; your voice should come through a few seconds late.
  • Your listener statistics show that second device tuned in right now.
  • Talk for thirty seconds over music and listen for clipping; pull the master fader down if the meters hit red.

Run the whole list once on a test day, not five minutes before the show. On a self-managed Icecast server, the basic setup guide suggests confirming the source through the server's stats.xml page.

When it goes wrong

SymptomLikely causeWhat to do
Recording stops at once with an errorWrong host, port, user or passwordRetype each part; check for special characters in the password
Connects to an old self-hosted server only with errorsIcecast before 2.4.0 does not accept HTTP PUTFFmpeg's legacy_icecast option exists for those servers; upgrading Icecast is the cleaner fix
An Ogg stream misbehaves in playersContent type left at audio/mpegSwitch to MP3, or set content_type to the Ogg type
Meters move but the listen link stays silentThe programme mix is on a track the output does not sendTick the right audio track in the Recording tab
Timer stops after a network dropThe connection was lost and did not resumePress Start Recording again and recheck the listen link

Still stuck? Open a ticket or chat from the support page with the address you typed, with the password replaced by stars.

Where this route is the wrong tool

The custom FFmpeg output is a general-purpose path, not a radio encoder. OBS's wiki does not describe reconnection for it, and it ties up the Record output. If your show is audio only, a dedicated encoder such as BUTT, Mixxx, SAM Broadcaster or RadioBOSS does the same job with fewer fields, and Premium and Platinum stations can also go live with the studio encoder that runs in the browser, nothing to install.

If you want pictures as well as sound, send OBS to a video channel over RTMP instead. Our live video streaming plays it as HLS in any browser, and OBS's ordinary Stream settings take the server and stream name.

Running it on our radio service

Every station starts on Icecast, and any encoder that speaks Icecast or SHOUTcast will do, OBS audio among them. Listeners hear it over HTTPS, so the player embeds on a secure website without mixed-content warnings. A free plan lets you prove the whole chain before you pay for more listeners or bitrate.

  • On paid plans, AutoDJ keeps your uploaded tracks playing day and night, then steps aside the moment a live DJ connects.
  • On Platinum, your encoder connects to the nearest of five cities, which forwards the broadcast to your station; passwords and DJ slots behave as before.
  • Support runs day and night by live chat, where an assistant can check your account and hands you to a staff member on request.

Questions people ask

Can the OBS Stream button send to Icecast?

Not with the built-in services list. The working route is the Recording tab in Advanced output mode, with Custom Output (FFmpeg) set to Output to URL. You start and stop the broadcast with Start Recording and Stop Recording.

Which username goes in the icecast:// address?

Icecast's default source username is source. Use it unless your server or control panel gives a different one. The password is the source password for encoders, not the login for your account.

Can I record the show locally while OBS is broadcasting to Icecast?

Not from the same OBS profile, because the Record output is carrying the broadcast. Record from another point in your chain, or on our paid radio plans let the station record each live show to the library.

What bitrate should I set in OBS?

Use your plan's ceiling or lower: 32 kbps on Free, 128 kbps on Premium and up to 320 kbps on Platinum. Talk radio sits comfortably low; music benefits from the higher figures.

Does OBS reconnect by itself if my internet drops?

Do not count on it with this output. Watch the recording timer in the status bar, and if it stops, press Start Recording again and recheck the listen link. On paid plans AutoDJ fills the air while no live source is connected.

Radio

Put your stream on air

Start a station on the free plan, copy its encoder details into OBS, and check the HTTPS listen link from your phone.