A 10% gift is waiting on your first Pro plan. Use code GIFT10 at checkout. See all offers
Getting started

How to Install StreamSera and Set Up Your Radio Station

Install the free plugin from WordPress.org and get your first station and player online with the setup wizard.

On this page
  1. Before you start
  2. Step 1: Install the plugin
  3. Step 2: Activate StreamSera
  4. Step 3: Add your station
  5. Step 4: Choose how it looks
  6. Step 5: Put it on your site
  7. Step 6: You’re on air
  8. Run the wizard again
  9. What’s next

This guide takes you from a fresh install to a working radio player on your site. The built-in setup wizard does most of the work: paste your stream link, choose a look and pick where the player goes. Plan on about five minutes.

Before you start#

  • WordPress 6.6 or newer and PHP 7.4 or newer.
  • Your stream link (for example https://stream.example.com/live.mp3). If your site uses HTTPS, use the HTTPS version of the stream.
  • Optional: a square logo for your station, 300 × 300 px or larger.

Step 1: Install the plugin#

  1. In your WordPress admin, go to Plugins → Add New Plugin.
  2. Type StreamSera in the search box.
  3. On the StreamSera – Live Radio Player & Station Manager card, click Install Now.
Searching for StreamSera on the Add Plugins screen with the Install Now button highlighted
Search for StreamSera (1) and click Install Now (2).

Step 2: Activate StreamSera#

When the installation finishes, the button changes to Activate. Click it.

The StreamSera plugin card with the Activate button highlighted
Click Activate.

StreamSera opens its setup wizard straight away. If you have already finished the wizard on this site before, you go to the StreamSera dashboard instead.

Tip: Prefer to upload the plugin yourself? Download the zip from WordPress.org, then go to Plugins → Add New Plugin → Upload Plugin, choose the zip file and click Install Now.

Step 3: Add your station#

The first step of the wizard asks for your stream link.

  1. Paste your stream link into the Stream link box.
  2. StreamSera checks the stream automatically. You can also click Check stream (or Check again).
Step 1 of the setup wizard with the empty Stream link box highlighted
Paste the stream link from your radio host.

When the stream answers, you see a green Stream found box with the format and bitrate, and the song that is playing if your server reports it. StreamSera fills in the station name for you.

The wizard after a successful check showing Stream found, station name, genre and station logo fields
The stream was found (1). Check the name and add a genre (2) and a logo (3).
  1. Check the Station name and change it if you like.
  2. Add a Genre such as Community, Jazz or Talk (optional).
  3. Click Choose image to add your Station logo (optional). It is shown when a song has no artwork.
  4. Click Continue.

The live preview on the right shows how visitors will see the player. You can switch between desktop and phone view at the top of the preview.

Stream not found?: If the check fails, make sure you copied the full stream address, including https:// and the mount name (such as /live or /stream). On an HTTPS site, the stream must be HTTPS too.

Step 4: Choose how it looks#

Pick a starting point for your player. Everything can be fine-tuned later in the player builder.

Step 2 of the setup wizard showing layout choices, style options and accent colours with a live preview
Choose a layout, a style and an accent colour. The preview updates as you click.
  • Layout: Card, Hero, Compact, Listen live button or Station shelf.
  • Style: Modern, Minimal, Neon, Glass or Dark Studio.
  • Accent colour: the color of the play button and highlights. Pick a preset or click the color wheel for your own.

Click Continue, or Use the defaults to keep the suggested look.

Step 5: Put it on your site#

Choose where listeners will find your player.

Step 3 of the setup wizard with the options Add it to a page, Create a listen page and I’ll add it myself
Pick one of the three options, then click Finish setup.
  • Add it to a page (A): place the player on a page you already have, or let StreamSera create a new page. Choose the page and, for a new page, type its title.
  • Create a listen page (B): a ready-made, full-screen page just for your station. It opens in its own tab, so the music keeps playing while visitors browse your site.
  • I’ll add it myself (C): use the StreamSera block, a shortcode or your page builder later.

Click Finish setup. StreamSera creates one station and one player.

Step 6: You’re on air#

The last screen confirms that everything is ready.

The You’re on air screen with View it on your site and Fine-tune in the builder buttons
Open your page (1) or fine-tune the player in the builder (2).
  • View it on your site opens the page with your player.
  • Fine-tune in the builder opens the player builder, where you can change colors, fonts, the parts that are shown and more.
  • Under Next, when you’re ready you can add more stations, turn on station pages or add the player to more pages.
The new Listen live page on the site with the StreamSera player showing the current song
Your player on the site, showing the song that is playing.

Run the wizard again#

You can run the setup wizard any time, for example to add another station with its own player. Go to StreamSera → Dashboard and click Run the setup wizard in the Get on air box. To skip the wizard, click Skip setup at the top right; you can add stations and players by hand later.

What’s next#

Still stuck?Our team usually replies the same day. Open a private ticket and we'll help you sort it out. Open a ticket