Skip to content
Checks if a particular Chromecast is idle, and switches off specified TV/Hifi equipment after a timeout. Also allows controlling of volume by CEC for surround-sound media.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information. Update Jan 13, 2020 clean up and finalise setup process Jan 13, 2020
chromecast_controls@USERNAME.service updates for new name and functions Jan 3, 2020
requirements.txt Initial commit Nov 24, 2019


Implements better CEC controls for Chromecasts. Currently has two functions:

  • checks if a particular Chromecast is idle, and switches off specified TV/Hifi equipment after a timeout. Will save energy being wasted by having your TV or hifi on when you're not watching anything.
  • sends CEC volume commands when Chromecast volume is changed (useful for surround-sound media which Chromecast doesn't let you control volume for)

Tested on Raspberry Pi running Raspbian Buster.

Installation (without VirtualEnv)

  1. Set up Raspbian (Buster) on your Raspberry Pi. Make sure it's connected to the same network (either Ethernet or Wifi) as your Chromecast. The HDMI port also needs to be connected to the TV or receiver your Chromecast is connected to.
  2. Ensure Python 3.7 or later is installed (this is the default in Raspbian Buster)
  3. Clone this repository, or download the zip and extract the files, then go into the directory thus created.
  4. Install CEC in the OS: sudo apt-get install libcec-dev libcec4
  5. Install requirements: sudo pip3 install -r requirements.txt
  6. Run sudo python3 --setup for interactive setup and install



Chromecast can switch on modern TVs/receivers (using HDMI CEC) when you start casting to it. But for some reason, Google didn't implement a feature to switch off devices when it's been sitting idle for a while. This wastes power (somewhere in the ballpark of 50-100W). ChromecastControls fixes this by detecting when the Chromecast is sitting idle, and putting any connected equipment into standby.


Ever see the message "Surround Sound enabled. To adjust volume, use your TV's remote control" when trying to change the volume for something you're casting from your phone? Chromecast can modify volume for stereo sources, but not surround sound. However, CEC can send a signal to your TV/receiver to change the volume. Why the Chromecast doesn't send this signal is anyone's guess. But ChromecastControls can detect when you've attempted to change the volume via your phone, and sends the corresponding CEC signals to your equipment.


The PyChromecast library can listen on your network for any events related to your Chromecast. In this case, the events we're listening for are status changes (an app connects to or disconnects from the Chromecast) or volume changes. When ChromecastControls detects such a change it sends a corresponding signal on the HDMI CEC bus to control the equipment (using libcec and python-cec). The Raspberry Pi is perfect for this as it has an inbuilt CEC signalling in the HDMI connector - most computers don't have this (you could try a Pulse-8 adapter, but this hasn't been tested). For standby/power-off, ChromecastControls first waits for a set amount of time before turning things off.

You can’t perform that action at this time.