Monitorian

Monitorian is a Windows desktop tool to adjust the brightness of multiple monitors with ease.

<img src="Images/Screenshot_main.png" alt="Screenshot" width="487.5"><br> (DPI: 200%)

The user can change the brightness of monitors, including external ones, either individually or in unison. For the system with an ambient light sensor, the adjusted brightness can be shown along with configured one.

<br> (DPI: 100%)

In addition, the user can change the adjustable range of brightness and contrast for each monitor seamlessly.

  <br>

https://user-images.githubusercontent.com/7205690/210137118-66cfdd6e-9847-41b3-a836-d1ff8cf73f3d.mp4

Additional languages:

• Arabic (ar) by @MohammadShughri
• Catalan (ca) by @ericmp33
• German (de) by @uDEV2019
• Greek (el-GR) by @NickMihal
• Spanish (es) by @josemirm and @ericmp33
• Persian (fa-IR) by @sinadalvand
• French (fr) by @AlexZeGamer and @Rikiiiiiii
• Italian (it) by @GhostyJade
• Japanese (ja-JP) by @emoacht
• Korean (ko-KR) by @VenusGirl
• Dutch (nl-NL) by @JordyEGNL
• Polish (pl-PL) by @Daxxxis and @FakeMichau
• Portuguese (pt-BR) by @guilhermgonzaga
• Romanian (ro) by @calini
• Russian (ru-RU) by @SigmaTel71 and @San4es
• Albanian (sq) by @RDN000
• Swedish (sv-SE) by @Sopor
• Turkish (tr-TR) by @webbudesign
• Ukrainian (uk-UA) by @kaplun07
• Vietnamese (vi-VN) by @dongsinhho
• Simplified Chinese (zh-Hans) by @ComMouse, @zhujunsan, @XMuli, @FISHandCHEAP and @FrzMtrsprt
• Traditional Chinese (zh-Hant) by @toto6038 and @XMuli

Requirements

• Windows 7 or newer
• .NET Framework 4.8
• An external monitor must be DDC/CI enabled.

Download

• Microsoft Store (Windows 10 (1607) or newer):<br> Monitorian<br> <a href='//www.microsoft.com/store/apps/9nw33j738bl0?cid=storebadge&ocid=badge'><img src='https://developer.microsoft.com/store/badges/images/English_get-it-from-MS.png' alt='Monitorian' width='142px' height='52px'/></a>

• Winget (a.k.a. Windows Package Manager, App Installer):

  winget install Monitorian -s msstore
  

• Other:<br> :floppy_disk: Installer

Install/Uninstall

If you wish to place executable files on your own, you can extract them from installer file (.msi) by the following command:

msiexec /a [source msi file path] targetdir=[destination folder path (absolute path)] /qn

In such case, please note the following:

• The settings file (and other file) will be created at: [system drive]\Users\[user name]\AppData\Local\Monitorian\
• When you check [Start on sign in], a registry value will be added to: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run

Remarks

• The monitor name shown in main window can be changed to distinguish monitors easily. To change the name, press and hold it until it turns to be editable.
• To adjust the brightness by a touchpad, place two fingers on it and swipe horizontally. The touchpad must be a precision touchpad.
• The number of monitors shown at a time is up to 4.
• In case an external monitor is not shown, read detection of external monitors.
• This app identifies each monitor by an unique identifier given by the OS. Even with the same PC and monitor, this identifier may vary depending on the type of connection (e.g. USB-C DisplayPort Alt mode) or the selection of connectors of the same type. Consequently, if a monitor is reconnected to the different connector, it may not be regarded as the same monitor and some functions may not work as expected.

Add-on Features

Add-on features are available for Microsoft Store version on a subscription basis.

Hot keys & Shortcut keys (Add-on features)

All hot keys for brightness can be switched to contrast by To contrast hot key. It can be switched back to brightness by To brightness hot key.

Command-line options (Add-on features)

You can use command-line options to get/set the brightness or contrast.

| Actions | Options | |----------------------------------------|----------------------------------------| | Get brightness of a monitor. | /get | | Get brightness of a specified monitor. | /get [Device Instance ID] | | Get brightness of all monitors. | /get all | | Set brightness of a monitor. | /set [Brightness] | | Set brightness of a specified monitor. | /set [Device Instance ID] [Brightness] | | Set brightness of all monitors. | /set all [Brightness] |

The device instance ID is an unique identifier given by the OS to each monitor. It must be enclosed in quotes.

You can switch to contrast by inserting contrast after /get or /set (e.g. /get contrast all).

If this app is called with /get or /set, it will return

[Device Instance ID] [Monitor name] [Brightness] B

'B' at the end indicates brightness. In addition, '*' will be added in the case of a selected monitor.

If this app is called with /get contrast or /set contrast, it will return

[Device Instance ID] [Monitor name] [Contrast] C

'C' at the end indicates contrast. If contrast is not supported by a monitor, '-' will be shown instead.

The brightness or contrast ranges from 0 to 100%. When you use /set option, it can be specified with the number itself (e.g. 20), increase (e.g. +10) or decrease (e.g. -10).

The options can be executed consecutively (e.g. monitorian /set 20 /set contrast 40, up to 10 options).

You can call this app by its name Monitorian in command prompt, bat file or desktop shortcut.

For example, creating a desktop shortcut to set brightness of a monitor to 50 will be the following.

From Task Scheduler, it can be performed by the path to its alias %LOCALAPPDATA%\Microsoft\WindowsApps\Monitorian.exe. For example, to increase brightness of all monitors by 30%, the Action will be the following:

In addition, you can customize flexible and versatile commands for specific needs:

• Conditional Commands - To be executed when a specified condition is met
• Time Commands - To be executed when a specified daily due time comes
• Key Commands - To be executed a specified hot key is pressed

The code for add-on features is not included in this repository.

Detection of external monitors

This app checks if each external monitor is controllable through DDC/CI and shows only controllable ones.

For this purpose, this app requests a monitor to send its capabilities information through DDC/CI and checks if it includes the capabilities to get/set the brightness. If capabilities information is not received or these capabilities are not included, such monitor will be regarded as not controllable through DDC/CI.

This function has been tested and worked well in most cases. Therefore, if a monitor is not shown, it is most likely caused by hardware-oriented reasons that cannot be solved by this app. Such reasons include:

1. The monitor model does not support DDC/CI.

2. The monitor's DDC/CI setting is OFF. You may need to change the setting by OSD menu.

3. The monitor's DDC/CI function is weird. Some monitors are found not to return correct capabilities information.

4. The PC's connector does not support DDC/CI.

5. The cable, converter, or docking station which connects the PC and the monitor is not compatible with DDC/CI. Thunderbolt/USB-C cables are generally compatible but converters aren't. Surface Dock and Surface Dock 2 are known to be compatible.

6. The monitor or the PC have issues including contact failure in connector. This is particularly the case for old monitors.

If you think it is worth to report, read reporting and then create an issue with logs and other relevant information.

Development

To begin with, please read contributing guidelines.

This app is a WPF app developed and tested with Surface Pro series.

Reporting