https://github.com/xtoshiro/display-control
An optimized, lightweight multi-monitor brightness, contrast, and color temperature controller using DDC/CI in Python. (Se preferir em português: Um controlador de brilho, contraste e cor leve e otimizado para múltiplos monitores usando Python e DDC/CI.)
https://github.com/xtoshiro/display-control
brightness-control customtkinter ddc-ci monitor-control multi-monitor python windows-utility
Last synced: 5 days ago
JSON representation
An optimized, lightweight multi-monitor brightness, contrast, and color temperature controller using DDC/CI in Python. (Se preferir em português: Um controlador de brilho, contraste e cor leve e otimizado para múltiplos monitores usando Python e DDC/CI.)
- Host: GitHub
- URL: https://github.com/xtoshiro/display-control
- Owner: xToshiro
- Created: 2026-06-12T19:07:44.000Z (5 days ago)
- Default Branch: main
- Last Pushed: 2026-06-12T20:33:30.000Z (5 days ago)
- Last Synced: 2026-06-12T21:18:53.168Z (5 days ago)
- Topics: brightness-control, customtkinter, ddc-ci, monitor-control, multi-monitor, python, windows-utility
- Language: Python
- Homepage: https://github.com/xToshiro/display-control/releases
- Size: 69.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🖥️ AOC Display Control Panel
[](https://www.python.org/)
[](https://www.microsoft.com/windows)
[](LICENSE)
[](https://github.com/xToshiro/display-control/releases/tag/v1.2.0)
An optimized, lightweight, and modern alternative to the AOC I-Menu. This application provides a sleek side-by-side dark-mode control interface for managing image settings on dual AOC monitors using the VESA DDC/CI protocol.
---
## 🌟 Key Features
* **⚡ Zero-Lag Asynchronous Engine**: All hardware communications (reads and writes) are processed in sequential background worker threads. The GUI remains 100% fluid and responsive.
* **🖥️ Side-by-Side Dual-Monitor Panel**: View and control both displays independently side-by-side, identified by their correct model (`27B35H`) and serial numbers extracted directly from EDID metadata.
* **🔗 Dynamic Sync mode**: Bind parameters together so adjusting brightness or contrast on one monitor automatically mirrors it onto the other.
* **🎨 Low-Level Color Presets**: Supports raw VESA VCP Code `0x14` commands to instantly set monitor color temperatures:
- `sRGB` (1)
- `6500K` (5)
- `7500K` (6)
- `9300K` (8)
- `User/Usuário` (11)
* **🌙 Global Profiles**: Apply pre-configured profile configurations (`Leitura`, `Trabalho`, `Jogos`, `Noite`) to both displays simultaneously.
* **⚙️ Resolução e Proporção**: Altere a proporção da imagem do monitor (Wide, Aspect, 1:1) via hardware com DDC/CI (VCP `0x86`) e troque a resolução/frequência de tela do Windows diretamente pela interface.
* **💾 Perfis Personalizados**: Crie e gerencie perfis personalizados contendo brilho, contraste, cor e escala para todas as suas telas, além de escolher qual inicia por padrão no boot do sistema.
* 📥 Minimize to System Tray: Closes directly to the system tray (pystray). Includes context menu presets so you can adjust your screens without even opening the main window.
* 🔒 Single Instance Protection: Prevents duplicate application windows from spawning. Re-running the application shortcut safely restores, lifts, and focuses the existing background process window.
* 📱 Dynamic Adapting Layout: Automatically adjusts the window width and columns dynamically depending on the number of connected monitors (works seamlessly for 1, 2, 3, or more displays).
* ⚙️ Start on Boot: A checkbox that creates a Windows registry key to automatically launch the application minimized on system startup.
---
## ⚙️ Hardware Prerequisites
To communicate with your monitors, please ensure:
1. **DDC/CI is Enabled** in the physical monitor's OSD (On-Screen Display) menu.
2. The displays are connected via modern video interfaces (**HDMI**, **DisplayPort**, or **USB-C**). VGA and older DVI connections do not support the protocol.
---
## 📦 Download the Executable
If you do not wish to run from source, you can download the compiled standalone executable:
👉 **[Download DisplayControl.exe (v1.2.0)](https://github.com/xToshiro/display-control/releases/download/v1.2.0/DisplayControl.exe)**
*(Built using PyInstaller with a custom icon, running silently without a console window).*
---
## 🚀 Running from Source
### 1. Requirements
Ensure you have **Python 3.14+** installed.
### 2. Setup Virtual Environment
```bash
# Clone the repository
git clone https://github.com/xToshiro/display-control.git
cd display-control
# Create and activate virtual environment
python -m venv venv
.\venv\Scripts\activate
```
### 3. Install Dependencies
```bash
pip install -r requirements.txt
```
### 4. Launch
```bash
python main.py
```
*To run the script in the background without launching a Command Prompt window, run with:*
```bash
pythonw.exe main.py
```
---
## 🛠️ Building Standalone Binary
To compile the source code into a standalone `.exe` executable file using PyInstaller:
```bash
pip install pyinstaller
pyinstaller --onefile --noconsole --name="DisplayControl" --icon="app_icon.ico" main.py
```
The compiled file will be located inside the `dist/` directory.
---
## 📄 License
This project is licensed under the MIT License.