Skip to content

Getting Started

Arie J. Godschalk edited this page Nov 15, 2026 · 1 revision

Home

Getting started

Choose what you need

Feature Google setup What you get
Text-to-Speech Google Cloud project, billing, Text-to-Speech API and service-account JSON Configurable speech audio hosted temporarily by Homey
Text-to-Speech (Non-Cloud) No Google Cloud account or key configured in this app Short speech URL hosted by Google
Google Translate Google Cloud project, Translation API, service-account JSON and project ID; check current billing requirements Translated text
YouTube Google Cloud project, YouTube Data API v3 and API key First matching video ID and link

These are separate requirements. A Homey account is not a Google Cloud account. A service-account JSON is not a YouTube API key; configuring one does not configure the other. Non-Cloud speech does not require the cloud JSON. You still need internet access for these services.

Google Cloud setup

  1. Sign in to Google Cloud Console with your own Google account and create or select a project.
  2. For cloud speech, enable billing and enable the Cloud Text-to-Speech API in the API library. For translation enable Cloud Translation API, and check the project's current billing status and requirements. For YouTube search enable YouTube Data API v3.
  3. For speech or translation, create a service account with only the permissions needed for your chosen services. If your organization permits service-account keys, create and download a JSON key. This file is a secret; do not share, commit, or paste it into forums. Avoid granting the project Owner role suggested in older community posts.
  4. For YouTube, create an API key in the project's Credentials page; restrict it as appropriate for your setup. Test that the restriction permits Homey's requests. See Google's key guidance.
  5. In Homey, open Apps → Google Services → Settings, enter only the values needed for your chosen features and save. See App settings.

Google controls API availability, quotas and billing. Cloud speech requires billing and charges can apply after any current free allowance; Translation has separate pricing. YouTube has its own quota. Consult speech pricing, translation pricing and YouTube quota information. Do not assume an old forum's limits still apply.

Add a device and test

In Homey choose Add device, select Google Services and the device type, then follow the pairing screen. Add separate instances when you want independent device settings or trigger routes. Open Devices for settings, then try a first Flow.

Clone this wiki locally