Monitor Switch
github.com
- Free plan
- Linux
- Web
- API
- Self-hosted
What Monitor Switch is
Monitor Switch is a free, MIT-licensed service for changing a monitor's input source and controlling other DDC/CI features. It offers a browser interface, HTTP API, scripts, and Home Assistant access. Depending on what the monitor exposes, controls include brightness, contrast, volume, mute, picture mode, colour temperature, RGB gain, and black level. It can also read details such as usage hours, firmware level, refresh rates, and power state. Editable profiles set monitor values and can replace capability detection when the monitor reports incorrect options. For Home Assistant, MQTT discovery exposes profile features as entities such as selectors, sliders, and sensors. Setup requires a Raspberry Pi running Raspberry Pi OS, connected to the monitor by HDMI and reachable over SSH; installation uses an Ansible playbook. Hardware verification is reported for a Samsung Odyssey G9 with a Raspberry Pi Zero 2 W, while other monitors have not been verified. The project is described as usable but not yet released. It has no authentication and is intended for a trusted LAN. A switch to a computer that is off can show a black screen, and the service cannot detect that beforehand.
Who it suits
Monitor Switch suits people who use one monitor with multiple computers and want to change inputs or adjust exposed monitor settings through a browser, scripts, or Home Assistant. It requires a Raspberry Pi setup and a trusted LAN.
Good to know, and what to watch
- Free and MIT licensed.
- Controls monitor inputs through HTTP and web UI.
- Can expose controls to Home Assistant.
- Profiles can override incorrect capability detection.
- Reads monitor status and usage details.
- Requires a Raspberry Pi and SSH setup.
- No authentication; intended for a trusted LAN.
- Other monitors have not been hardware verified.
- An off computer can leave a black screen.
Plans
Every plan and priceMIT-licensed open-source software
Open source
Getting started
- Prepare a Raspberry Pi running Raspberry Pi OS
- Connect the Raspberry Pi to the monitor by HDMI
- Ensure the Pi is reachable over SSH
- Install Monitor Switch with its Ansible playbook
- Open the browser interface or connect through the HTTP API, scripts, or Home Assistant
- Define monitor profiles if automatic capability detection is incorrect
Limits to check
Switching to a computer that is off can produce a black screen, and the service cannot detect that condition in advance. After an input change, a complete monitor-value reread takes around 20 seconds on a Pi Zero; the default input-source polling interval is 15 seconds.
The Club's review
Overview
Monitor Switch is a DDC/CI service for changing monitor inputs and settings through a browser, HTTP API, scripts, or Home Assistant. It best suits people who share a display between computers and are comfortable setting up a Raspberry Pi. Its automation options are unusually broad for a monitor utility, but the Pi requirement and unverified compatibility beyond one monitor narrow its appeal.
Key features
Input switching is the core use: a Pi connected to the monitor can change its source without software running on each computer. When a display exposes the relevant DDC/CI controls, Monitor Switch can also adjust brightness, contrast, volume, mute, picture mode, colour temperature, RGB gain, and black level. It reads monitor data such as usage hours, firmware level, refresh rates, and power state, giving it more reach than a simple source selector.
Editable profiles define monitor values and can correct capability detection when a display reports its controls inaccurately. Home Assistant discovers profile features over MQTT and presents them as entities, including selectors, sliders, and sensors. This makes Monitor Switch a sensible choice for users building monitor controls into home-automation routines; it is less compelling for someone who only wants a quick desktop brightness control.
Setup takes more work than installing an ordinary desktop app. The service runs on a Raspberry Pi with Raspberry Pi OS, connected to the monitor over HDMI and reachable through SSH; installation uses an Ansible playbook. Hardware checks cover a Samsung Odyssey G9 paired with a Raspberry Pi Zero 2 W, while other monitors remain unverified. After an input change, a full monitor-value reread takes about 20 seconds on a Pi Zero, so reported settings may briefly lag. Home Assistant state is polled, with input-source polling set to 15 seconds by default.
There is also a consequential blind spot: switching to a computer that is off can leave the screen black, and Monitor Switch cannot identify that state beforehand. The service has no authentication and is intended for a trusted LAN. It binds to a configurable address rather than 0.0.0.0 by default, but that does not make it appropriate to expose beyond a network the user trusts.
Pricing
Monitor Switch is free open-source software under the MIT license. Its single plan costs nothing and includes the service without a paid tier or trial to weigh. The trade-off is operational rather than financial: users need a Raspberry Pi, a compatible monitor and the patience to configure and maintain a self-hosted service.
Platforms
Monitor Switch is listed for web, Linux, API, and self-hosted Raspberry Pi use. The browser interface and HTTP API provide direct access, while scripts and Home Assistant offer other control paths. The Pi requirement means Linux support should not be read as a conventional desktop-only installation.
Who it's for
Choose Monitor Switch if you move one monitor between computers, want to manage its exposed settings centrally, or plan to connect those controls to Home Assistant. It is a better fit for technically comfortable users with a Raspberry Pi and a trusted LAN than for first-time users looking for a polished utility they can install on a single computer. If the monitor’s compatibility is uncertain, the narrow hardware verification makes a simpler, platform-specific option less of a gamble.
Pros and cons
- Pro: Several control routes—browser, HTTP API, scripts, and Home Assistant—let users choose direct control or automation.
- Pro: Profiles can override incorrect capability detection, helping users adapt settings to a monitor’s reported features.
- Con: Raspberry Pi OS, HDMI connection, SSH access, and Ansible installation add setup and hardware requirements.
- Con: Compatibility verification covers only one reported monitor setup, leaving other displays uncertain.
- Con: An input change to a powered-off computer can produce a black screen, and the service cannot warn in advance.
- Con: No authentication and a trusted-LAN design limit where the service should be reachable.
- Con: Monitor values may take around 20 seconds to refresh after switching on a Pi Zero.
Alternatives
For an option specific to a particular computer platform or monitor maker, Lunar is a macOS alternative with a free version and a free trial. AOC G-Menu is a free Windows choice for supported AOC devices. Linux users who want a free MIT-licensed brightness tool can consider Monitor Brightness Control, which requires a DDC/CI-compatible monitor and I2C access.
Twinkle Tray is free for Windows 10 and 11 and covers most laptops and DDC/CI-enabled monitors. On macOS, BetterDisplay offers a free version and a Pro perpetual license for $21.99, paid once, with at least one year of updates for covered versions. Linux users seeking free software can also consider DDCcontrol or ddcutil; the latter is available for Linux, API, and self-hosted use under GPLv2. ASUS DisplayWidget Center is a free option for compatible ASUS monitors on macOS or Windows.
For more choices in this category, see Monitor Control Software.
Verdict
Monitor Switch is best for Raspberry Pi users who share a monitor between computers and want its input and exposed settings available to scripts or Home Assistant. Its broad controls and editable profiles give automation-minded users a strong reason to choose it, especially at no software cost. Look elsewhere if you need verified support for a particular monitor, desktop-only setup, or protection against switching to a computer that is off.
The verdict
Monitor Switch offers monitor input and settings control through several interfaces, with Home Assistant support and editable profiles. It is usable but not yet released, and its hardware checks are limited to one reported monitor setup.
Questions people ask
What does Monitor Switch control?
It changes the monitor input source using DDC/CI and can expose brightness, contrast, volume, mute, picture mode, colour temperature, RGB gain, and black level when the monitor provides them.
How is it deployed?
It runs on a Raspberry Pi connected to the monitor by HDMI. Setup uses Raspberry Pi OS, SSH access, and an Ansible playbook.
Does it integrate with Home Assistant?
Yes. MQTT discovery exposes profile features as Home Assistant entities, including selectors, sliders, and sensors.
Is Monitor Switch free and open source?
Yes. The plan is MIT-licensed open-source software at no cost.
What security model does it use?
The service has no authentication, is intended for a trusted LAN, and binds to a configurable address rather than 0.0.0.0 by default.
Which hardware has been verified?
The maker reports real-hardware checks with a Samsung Odyssey G9 and Raspberry Pi Zero 2 W. Other monitors have not been verified.
What the maker publishes
- Access
- Controls are available through a browser interface, HTTP API, scripts and Home Assistant. source
- Compatibility evidence
- The project says its real-hardware checks were performed on a Samsung Odyssey G9 with a Raspberry Pi Zero 2 W; other monitors have not been verified. source
- Controls
- It can control input source, brightness, contrast, volume, mute, picture mode, colour temperature, RGB gain and black level when the monitor exposes them. source
- Deployment
- It runs on a Raspberry Pi connected to the monitor’s HDMI input and is installed with an Ansible playbook. source
- Hardware verification
- The maker reports that real hardware verification was performed with a Samsung Odyssey G9 and Raspberry Pi Zero 2 W; other monitors have not been verified. source
- Home Assistant
- The service uses MQTT discovery to expose profile features as Home Assistant entities, including selectors, sliders, and sensors. source
- Home Assistant integration
- The service announces monitor controls as Home Assistant entities using MQTT discovery. source
- Input switching limit
- Switching to a machine that is off shows a black screen, and the service cannot detect this in advance. source
- Integration state
- Home Assistant state is polled from the monitor, and the default input-source polling interval is 15 seconds. source
- Intended use
- The project is designed for people switching a monitor between computers, including when the currently displayed computer is off or asleep. source
- License
- The repository identifies the project as MIT licensed. source
- Limitations
- Switching to a computer that is off can show a black screen, and the service cannot detect that condition in advance. source
- Monitor controls
- It can expose monitor controls including brightness, contrast, volume, mute, picture mode, colour temperature, RGB gain, and black level. source
- Monitor information
- It can read monitor information such as usage hours, firmware level, refresh rates, and power state. source
- Monitor profiles
- Editable profiles define monitor feature values and can override incorrect capability auto-detection. source
- Profiles
- Editable profiles define monitor values, and can override auto-detection when a monitor reports incorrect capabilities. source
- Purpose
- Monitor Switch changes a monitor’s input source using DDC/CI, controlled through HTTP, a web UI, or Home Assistant. source
- Refresh delay
- After an input change, a full monitor-value reread takes around 20 seconds on a Pi Zero, so other values may briefly lag. source
- Release status
- The README describes the project as usable but not yet released. source
- Security
- The service has no authentication, is intended for a trusted LAN, and binds to a configurable address rather than 0.0.0.0 by default. source
- Setup requirement
- Setup requires a Raspberry Pi running Raspberry Pi OS, connected to the monitor by HDMI and reachable over SSH. source
Checked against the maker's pages on 8 Oct 2026.