Getting Started

Chromecast Receiver is an open web service that hosts a custom Cast receiver application you can configure with your own branding — logo, title, and player styling — entirely through environment variables. No code required. Use it to give your Chromecast integration a branded experience without writing or deploying a custom receiver.

Prerequisites

Step 1: Create a Chromecast Receiver instance

Navigate to the Chromecast Receiver service in the OSC web console. Click Create cast-receiver and fill in:

  • Name: a unique name for your instance (alphanumeric only, e.g. myreceiver)
  • Title: the display title shown on the receiver screen (e.g. My Video App)

Optionally:

  • PlaybackLogoUrl: URL to an image displayed during media playback (e.g. your app logo)
  • LogoUrl: URL to an image shown on the idle/splash screen
  • CastMediaPlayerStyle: custom CSS to override the default player appearance
  • CastReceiverOptions: JSON string passed to the Cast Receiver SDK CastReceiverOptions constructor (advanced)

Click Create and wait for the status indicator to turn green.

Step 2: Register your receiver URL

Once the instance is running, copy the service URL from the OSC web console. In the Google Cast SDK Developer Console:

  1. Select your Cast application (or create a new one of type Custom Receiver)
  2. Set the Receiver Application URL to your OSC service URL
  3. Save and publish the application

It can take a few minutes for the Cast infrastructure to pick up the new URL after publishing.

Step 3: Test casting

Using a Cast-enabled sender app or the Chrome browser extension, cast content to a device registered to your Application ID. Your branded receiver screen should appear with the title and logo you configured.

CLI usage

osc create eyevinn-cast-receiver myreceiver \
  -o title="My Video App" \
  -o logoUrl="https://cdn.example.com/logo.png"

Resources