Skip to content
Listen to your Overcast podcasts on Sonos.
PHP CSS Dockerfile Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows
css
images
.dockerignore
.gitignore
.prettierrc.json
Dockerfile
Dockerfile.test
LICENSE
Procfile
README.md
Sonos.wsdl
api.php
app.json
composer.json
composer.lock
debug.php
docker-compose.test.yml
fpm_custom.conf
index.php
overcast.php
pmap.xml
setup.php
smapi.php
sonos.php
strings.xml
test.sh

README.md

Unofficial Overcast + Sonos integration

Listen to your Overcast podcasts on Sonos.

Just want to try it out? Follow these setup instructions to register the Overcast service on your Sonos system.

Setup

Find the IP address of your Sonos.

From the iOS Sonos App, go to Settings > About My Sonos System.

Check out this Sonos support article if you're on another platform.

Register the custom service

Navigate to http://$IP:1400/customsd. For example, if your Sonos IP address was 10.0.1.10, you'd navigate to http://10.0.1.10:1400/customsd in your web browser.

Fill out the custom service registration form with the following values.

For the purpose of copy and paste:

Add Music Service

From the iOS Sonos App, go to Add Music Services and find Overcast in the list. Log in with your Overcast.fm email address and password.

Questions and Answers

Is this an official Overcast service?

No.

Do I have to run this thing on my computer?

Unlike AirSonos, you don't need to run any additional programs on your computer or network. A public instance of the service is already set up on Heroku.

Why can't I see my playlists?

This service is limited to the same functionality as the overcast.fm website, which only supports the "All Active Episodes" playlist.

What does "registering a custom service" do?

Sonos allows a unreviewed custom service to be registered for testing and development purposes. It's similar to "sideloading" an iOS app via Xcode. Typically, all services are reviewed and registered with Sonos.

Keep in mind that only one custom service can be registered per network. Because of this limitation, you can't use this Overcast service and another like the NPR One service at the same time.

Why isn't there a nice Overcast logo in the Sonos app?

Only officially registered services can set a custom service logo.

Why PHP?

I thought it would be fun and maybe @marcoarment would take the source and make it official.

Can I run my own service?

Yeah! If you want to make modifications or want to control your own instance for privacy reasons, you can simply use this "Deploy to Heroku" button to quickly set up your own app in minutes.

Deploy

You can’t perform that action at this time.