Skip to main content

library to push text message or sond to Google Home.

Project description

PyPI version

Google home push

Library for Python 3.4+ to push text message or audio file with the Google Home.


pip install googlehomepush


PyChromecast depends on the Python packages gTTS, pychromecast. Make sure you have these dependencies installed using pip install -r requirements.txt

How to use

from googlehomepush import GoogleHome



GoogleHome(devicename = None, host = None, port = None, tts_builder = googleTTS_Builder)

Create a new Google Home instance (a device name or host is mandatory).

  • devicename can be the google home name, or its IP (local).
  • host an ip of a Google Home
  • port port used to connect Google Home
  • tts_builder the tss engine to use. Available tts are:
    • googleTTS_Builder import with from googlehomepush.googletts import googleTTS_builder. Free TTS used by google translate. It's the default engine
    • googlecloudTTS_builder import with from googlehomepush.googlecloudTTS import googlecloudTTS_builder. Google cloud TTS engine. See to create an account.

.say(text, lang = 'en-US')

Push a message on Google home

  • text is the test message to say
  • lang the text language, default value is 'en'

.play(url, contentType = 'audio/mp3'):

Push a sond to Google home

  • url an audio file URL
  • contentType the audi file content type

You can play a local file using http_server

from googlehomepush.http_server import serve_file

file_url = serve_file("/path/to/file", "audio/mp3")
GoogleHome("LivingRoom").play(file_url, "audio/mp3")


  • Thomas Deblock (@tdeblock)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

googlehomepush-0.1.0.tar.gz (5.6 kB view hashes)

Uploaded Source

Built Distribution

googlehomepush-0.1.0-py3-none-any.whl (7.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page