Skip to content
Branch: master
Clone or download
Latest commit 7852f93 Jul 12, 2019

Local Home SDK sample

This sample shows how to integrate with the Local Home SDK. The Local Home SDK allow developers to add a local path to execute smart home intents by running TypeScript (or JavaScript) directly on Google Home smart speakers and Nest smart displays.


Run the sample

Set up the smart home project

Setup the virtual device

  • Open the smart home project in the Actions console, then perform these steps:
    • in Build > Actions > Smart home > Actions: Add the following attributes in the Device Scan Configuration:
      • UDP discovery address:
      • UDP discovery port in: 3312
      • UDP discovery port out: 3311
      • UDP discovery packet: ping
  • Start the virtual light strip server:
npm install --prefix device/
npm start --prefix device/ -- \
          --udp_discovery_port 3311 \
          --udp_discovery_packet ping \
          --device_id fakecandy-0

This starts a server that replies to UDP discovery packets with device information and displays openpixelcontrol commands to the terminal in a colorful way. Note: The server needs to listen on the same local network as the Home device.

Deploy the sample app

Serve the sample app locally from the same local network as the Home device, or deploy it to a publicly reacheable URL endpoint.

Deploy locally

  • Start the local development server:
npm install --prefix app/
npm start --prefix app/ -- --public

Note: The local development server needs to listen on the same local network as the Home device in order to be able to load the Local Home SDK application.

Deploy to Firebase Hosting

npm run build --prefix app/
npm run deploy --prefix app/ -- --project FIREBASE_PROJECT_ID

Test the Local Home SDK application

  • Reboot the Google Home Device
  • Open chrome://inspect
  • Locate the Local Home SDK application and click inspect to launch the Chrome developer tools.
  • Try the following query
    • Turn on the light
    • Turn off the light
    • Set the light brightness to 50
    • Set the light color to magenta

Test and Lint

npm test --prefix app/
npm run lint --prefix device/



You can’t perform that action at this time.