explaingit

agg23/cec-audio-mqtt-bridge

Analysis updated 2026-07-10 · repo last pushed 2018-04-29

PythonAudience · ops devopsComplexity · 3/5DormantSetup · moderate

TLDR

A Python tool that captures volume button presses from your TV remote over HDMI-CEC and forwards them to your smart home system via MQTT, letting your TV remote trigger automations like dimming lights or pausing movies.

Mindmap

mindmap
  root((repo))
    What it does
      Catches TV remote presses
      Sends MQTT messages
      Turns remote into trigger
    Hardware needs
      Raspberry Pi
      HDMI-CEC adapter
      TV with CEC support
    Tech stack
      Python
      MQTT
      HDMI-CEC
    Use cases
      Dim lights on mute
      Pause movie with remote
      Trigger smart home scenes
    Audience
      Smart home enthusiasts
      Home theater owners
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Use your TV remote mute button to dim lights and pause your movie for an intermission.

USE CASE 2

Trigger custom smart home scenes by pressing volume up or down on your TV remote.

USE CASE 3

Integrate TV remote volume controls into an existing MQTT-based home automation setup.

What is it built with?

PythonMQTTHDMI-CEC

How does it compare?

agg23/cec-audio-mqtt-bridge0xhassaan/nn-from-scratcha-little-hoof/dsr
Stars00
LanguagePythonPythonPython
Last pushed2018-04-29
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity3/54/55/5
Audienceops devopsdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an HDMI-CEC adapter or Raspberry Pi connected to your TV, plus an MQTT broker running on your network.

In plain English

cec-audio-mqtt-bridge lets your TV remote control things in your smart home. When you press the volume up, volume down, or mute button on your TV remote, this tool catches those button presses and forwards them to your home automation system. This means you could use your TV remote to dim the lights, trigger scenes, or really do anything your smart home supports, all without reaching for a separate remote or phone app. The tool works by pretending to be an audio receiver connected to your TV over HDMI. Many TVs can send volume commands to sound bars or receivers through a feature of HDMI called CEC. This bridge listens for those commands using a small hardware device connected to your setup, like a Raspberry Pi or a dedicated HDMI-CEC adapter. When it hears a volume command, it sends a corresponding message using a protocol called MQTT, which is a common way smart home devices talk to each other. Someone who would use this is likely a smart home enthusiast who already runs a home automation system and wants to integrate their TV remote into it. For example, if you have a home theater setup, pressing mute on your TV remote could not only silence your audio system but also pause your movie and dim the room lights to an intermission level. It turns an ordinary TV remote into a trigger for whatever automations you can dream up. The project is built in Python and requires a bit of technical setup. You need an MQTT broker, which is essentially a message hub for smart home devices, running somewhere on your network, plus the HDMI-CEC hardware to physically receive signals from your TV. The README does not go into detail about configuring specific home automation platforms, so you would need to know how to listen for MQTT messages on your particular system to make use of the volume commands.

Copy-paste prompts

Prompt 1
I have a Raspberry Pi connected to my TV via HDMI and an MQTT broker running on my network. How do I set up cec-audio-mqtt-bridge to listen for volume button presses and send MQTT messages?
Prompt 2
Using cec-audio-mqtt-bridge, I want my TV remote mute button to trigger a smart home scene that pauses my media player and dims the lights. How do I configure my home automation system to listen for the MQTT messages from this bridge?
Prompt 3
What HDMI-CEC adapter hardware is compatible with cec-audio-mqtt-bridge, and how do I connect it to my TV so the bridge can receive volume commands from my TV remote?
Prompt 4
Help me write a Home Assistant automation that reacts to the MQTT topics published by cec-audio-mqtt-bridge when I press volume up, volume down, or mute on my TV remote.

Frequently asked questions

What is cec-audio-mqtt-bridge?

A Python tool that captures volume button presses from your TV remote over HDMI-CEC and forwards them to your smart home system via MQTT, letting your TV remote trigger automations like dimming lights or pausing movies.

What language is cec-audio-mqtt-bridge written in?

Mainly Python. The stack also includes Python, MQTT, HDMI-CEC.

Is cec-audio-mqtt-bridge actively maintained?

Dormant — no commits in 2+ years (last push 2018-04-29).

How hard is cec-audio-mqtt-bridge to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is cec-audio-mqtt-bridge for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.