github-starred/MonitorControl
2
0
Fork 0
mirror of https://github.com/MonitorControl/MonitorControl.git synced 2026-05-15 14:15:55 -06:00
Code Issues 21 Projects Packages Wiki Activity Actions

Add troubleshooting page

Joni Van Roost 2020-02-25 21:48:54 +01:00
parent 572d491848
commit 8bb3d52597
1 changed files with 46 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

46
Monitor-Troubleshooting.md Normal file

@ -0,0 +1,46 @@
We often get issues like:
_"MonitorControl doesn't work with my monitor"_,
so here are some troubleshooting steps and general information to try and help you.
# General Information
* MonitorControl **doesn't work with every monitor**, it all depends on how well your display/cable manufacturer implements the [DDC/CI spec](https://en.wikipedia.org/wiki/Display_Data_Channel).
* Some displays will only support certain features well (for example, they work well with brightness but not volume).
* It also depends a lot on your [hardware combination](https://github.com/the0neyouseek/MonitorControl/issues/82).
# Troubleshooting
## I can't control volume/brightness
### Try a different ddc tool
First step you can try is a different ddc tool called [ddcctl](https://github.com/kfix/ddcctl).
If your setup works with ddcctl it should also work with MonitorControl.
After installing ddcctl, try something like:
```sh
./ddcctl -d 1 -v 30
```
(tries to set the volume of display 1 to value 30)
or
```sh
./ddcctl -d 1 -b 30
```
(tries to set the brightness of display 1 to value 30)
If these commands change your brightness or volume, you know that your display supports ddc (or at least the command that worked).
### Try a different cable
If the first step didn't work for you, your next best bet is trying a different cable/connection.
Generally, people seem to have the highest succes rates with DisplayPort and the lowest with HDMI.
## I can't get accurate read values from the monitor
If monitor is unable to read the values from the display, it will default to the last known values.
To try and fix this, you can try checking the `Longer Delay` option inside `Preferences > Advanced`.
See the [Advanced Preferences](https://github.com/the0neyouseek/MonitorControl/wiki/Advanced-Preferences#longer-delay) wiki page for more information.
## The app is slow on startup
This is usually because we poll the display to try and read its current volume/brightness on app launch.
You can lower or disable the `Polling Mode` inside `Preferences > Advanced`.
See the [Advanced Preferences](https://github.com/the0neyouseek/MonitorControl/wiki/Advanced-Preferences#polling-mode) wiki page for more information.