Repository navigation
Getting Started
| 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.
- Sign in to Google Cloud Console with your own Google account and create or select a project.
- 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.
- 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.
- 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.
- 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.
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.
Support development - If Google Services is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!