Reference Receiver: This Cast Design Checklist compliant media player shows a production ready custom receiver.
JavaScript CSS HTML
Switch branches/tags
Nothing to show
Latest commit 169ef17 Oct 12, 2017

CastReferencePlayer (reference receiver app)

This sample shows how to develop a fully Cast Design Checklist compliant receiver.

This receiver is not recommended for new development. We recommend you migrate to the Cast Application Framework (CAF) Receiver. Also see the Basic CAF Receiver sample app.

NOTE: The receiver code refers to the Autoplay UI logic as "PreviewMode" since the reference receiver already supports a playback feature called "autoplay".

Here is the list of other reference apps:

Setup Instructions

  • Get a Chromecast device
  • Upload the project to a website that can be accessed from your Chromecast. Later, when you publish your application, you will need to host so that it is accessible using HTTPS.
  • Register an application on the Developers Console ( Enter the URL for the player.html. There is a button marked publish, if you set that, then your receiver can be accessed by all devices, but it requires that you be serving using https. Not publishing your app, lets you restrict the receiver to devices that you specify and allows you to host on most development servers.
  • If you haven't already done so, please register the serial # of your Chromecast device in the developer console as well.
  • Using the Chromecast setup application, make sure [x] send your serial number to Google is checked. This is the only way that you can access your unpublished receiver. While you are in the Setup application, make a note of the IP address of your Chromecast. It will be helpful later if you wish to use the Chrome Remote Debugger.
  • 15 minutes after you have updated the developers console, you should reboot your Chromecast, so that it picks up the changes.
  • Enter the App ID of your receiver application into your sender application or one of our sample sender applications, such as DemoCastPlayer.
  • You should now be able to launch your receiver using a sender.
  • If you wish to watch whats going on, using a Chrome browser, connect to <IP of your Chromecast>:9222 and debug your receiver. A good place to start is looking at the console log.

References and How to report bugs

How to make contributions?

Please read and follow the steps in the




Your use of this sample is subject to, and by using or downloading the sample files you agree to comply with, the Google APIs Terms of Service and the Google Cast SDK Additional Developer Terms of Service.


Google Cast Developers Community on Google+