Listen to your Overcast podcasts on Sonos.
Branch: master
Clone or download
Latest commit 3d6e2c5 Jan 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
css Sync with Prettier Dec 16, 2018
images Add customsd steps May 5, 2018
.dockerignore Add Dockerfile Nov 19, 2018
.gitignore Update composer lockfile Jan 6, 2017
.prettierrc.json Prettier Nov 26, 2018
.travis.yml Add docker-compose.test.yml Jan 10, 2019
Dockerfile Add docker-compose.test.yml Jan 10, 2019
Dockerfile.test Add docker-compose.test.yml Jan 10, 2019
LICENSE Add LICENSE Dec 26, 2016
Procfile Set always_populate_raw_post_data=-1 Jan 12, 2017 Set image dimensions May 5, 2018
Sonos.wsdl Update WSDL Nov 23, 2018
app.json Add Heroku deploy button Feb 4, 2017
composer.json Require PHP 7.2.x in composer Dec 17, 2018
composer.lock Require PHP 7.2.x in composer Dec 17, 2018
debug.php Extract sonos class into shared file Nov 27, 2018
index.php Prettier Nov 26, 2018
overcast.php Fix extended episode CSS selector Jan 15, 2019
setup.php Prettier Nov 26, 2018
sonos.php Mark missing podcasts as unplayable Nov 27, 2018
strings.xml Add sample strings file Dec 26, 2016 Add docker-compose.test.yml Jan 10, 2019

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.


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, you'd navigate to in your web browser.

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

Add Music Service

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

Questions and Answers

Is this an official Overcast service?


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 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.