Monitor Control MQTT

Home Assistant compatible program to control PC monitors via MQTT.

Features

• Control laptop built-in screen brightness (via Windows API, using screen-brightness-control library)
• Control external monitors brightness, contrast and input source (via DDC/CI, using monitorcontrol library)
• Multiple monitor support
• Home Assistant compatible MQTT discovery

Requirements

• Windows 10 or later (older versions may work but are not tested)
• Python (tested on 3.14, but some older versions should work)
• Git (optional, for cloning the repository)
• MQTT broker
  • Home Assistant with Mosquitto broker app and MQTT integration
  • or something simpler like Eclipse Mosquitto

Installation

1. Clone the repository or download the source code.

git clone https://github.com/bartekl1/monitor-control-mqtt.git
cd monitor-control-mqtt

2. Install PIP dependencies.

pip install -r requirements.txt

3. Create configuration file config.yaml.

Minimal example:

mqtt:
  host: 192.168.1.123
  username: user
  password: pass

See config.template.yaml for all available options.

4. Run the script.

python main.py

5. (Optional) Configure script to run on startup. For example, you can use HKCU\Software\Microsoft\Windows\CurrentVersion\Run registry key or Task Scheduler.