Skip to main content

Mobile App Embeds

If your station has a mobile app, you can add a Listen Again page inside it. Your listeners can browse and play back episodes directly within the app.

Who is this for?

This is for stations that have a mobile app built by a third party — for example, using Aiir, Broadcast Radio, or a custom app developer. Most mobile apps let you add a page that loads a web address. This feature gives you a single URL to add as a page in your app.

How it works

AutoPod provides a lightweight player page designed specifically for mobile apps. Unlike the standard website widgets, this player:

  • Plays audio inline — no popups or redirects
  • Works in app webviews — tested with iOS and Android apps
  • Includes lock screen controls — listeners can pause, skip, and scrub from their lock screen or notification centre
  • Auto-plays the next episode — continuous listening
  • Uses your station's branding — colours and logo from your AutoPod settings
  • Supports dark, light, and system themes — matches your app's look

Layouts

There are two layout options:

Episodes (flat list)

A chronological list of your latest episodes. Listeners tap an episode to play it. Best for stations that want a simple, straightforward listen-again experience.

https://embedded.autopod.xyz/app/{your-stream-id}

Shows then Episodes

A grid of your shows. Listeners tap a show to see its episodes, then tap an episode to play. Best for stations with many shows who want listeners to browse by programme.

https://embedded.autopod.xyz/app/{your-stream-id}/shows

Getting your URL

The easiest way is from the dashboard:

  1. In your AutoPod dashboard, go to Widgets
  2. Click the Mobile App tab
  3. Choose your layout and customisation options
  4. Copy the generated link

The dashboard gives you a live preview so you can see exactly how it will look.

Customisation

You can customise the player's appearance by adding parameters to the URL. This is useful if you want the player to match your app's design.

Theme mode

Control whether the player uses a dark or light background:

ValueDescription
systemFollows the listener's device setting (default)
darkAlways dark background
lightAlways light background
https://embedded.autopod.xyz/app/123?mode=light

Colours

Override specific colours using hex values (without the #):

ParameterDescriptionExample
bgBackground colour1a1a2e
accentAccent/brand colour (buttons, highlights)e91e63
textPrimary text colourffffff
text_secondarySecondary text colour (subtitles, dates)999999
borderBorder colour333333
https://embedded.autopod.xyz/app/123?bg=1a1a2e&accent=e91e63

Bottom padding

If your app has a tab bar or navigation bar at the bottom that overlaps the player, increase the bottom padding. The value is in pixels.

ParameterDefaultDescription
bottom_padding80Extra space at the bottom for your app's chrome

Set to 0 if your app doesn't have a bottom bar:

https://embedded.autopod.xyz/app/123?bottom_padding=0

Set higher if the player is being cut off:

https://embedded.autopod.xyz/app/123?bottom_padding=120

Combining options

You can combine any of these parameters:

https://embedded.autopod.xyz/app/123/shows?mode=light&accent=e91e63&bottom_padding=100

All parameters are optional. If you don't set any, the player uses your station's colours from AutoPod and defaults to a dark theme that follows the device's light/dark setting.

Adding it to your app

The steps depend on which app builder you use.

Aiir

In your Aiir app CMS, add a new Custom Page and paste the URL as the page address.

Broadcast Radio

In the Broadcast.Radio portal, add a Custom Web Page to your app navigation and paste the URL.

Other app builders

Look for an option like "Custom Page", "Web Page", "Web View", or "External Link" in your app settings, and paste the URL there.

If you're not sure, contact your app provider and ask them to add a web page pointing to the URL above.

What listeners see

Episodes layout

  • Your station name and logo at the top
  • A chronological list of episodes with artwork, title, presenter, and date
  • Tapping an episode opens a full-screen player with large artwork, scrubber, and controls
  • A mini player bar at the bottom while browsing
  • Lock screen and notification centre controls

Shows layout

  • Your station name and a grid of shows with artwork
  • Tapping a show slides to its episode list (with a back button)
  • Tapping an episode opens the full-screen player
  • A mini player bar visible across both the shows and episodes views
  • Lock screen and notification centre controls

Troubleshooting

Audio doesn't play: Make sure your app is loading the URL in a webview (not opening it in the device's browser). The player is designed to work inside app webviews.

Player is cut off at the bottom: Your app's tab bar is overlapping the player. Add ?bottom_padding=120 (or higher) to the URL, or adjust the value in the dashboard.

Colours don't look right: Check that your hex colour values don't include the # symbol. Use bg=1a1a2e not bg=#1a1a2e.

Page looks wrong: Check that the URL is correct and includes your stream ID. You can find the correct URL on the Widgets page in your dashboard.

Need help? Contact AutoPod support and we'll help you get it set up.