Skip to content

kscreen-doctor

kscreen-doctor is a powerful command-line utility designed to assist users in managing and configuring display outputs on Linux systems. The tool allows detailed control over various display properties such as resolution, scaling, rotation, HDR settings, and more. Whether you are dealing with multiple monitors or want to adjust your display settings programmatically, kscreen-doctor provides an easy-to-use interface for a wide range of display configurations.

Dump all data for our monitors

> kscreen-doctor -o
Output: 1 DP-1
        enabled
        connected
        priority 1
        DisplayPort
        Modes:  0:3840x2160@60!  1:3840x2160@60  2:3840x2160@60  3:3840x2160@50  4:3840x2160@30  5:3840x2160@25  6:3840x2160@24  7:3840x2160@24  8:2560x1440@60*  9:1920x1080@60  10:1920x1080@60  11:1920x1080@60  12:1920x1080@60  13:1920x1080@60  14:1920x1080@50  15:1920x1080@50  16:1920x1080@30  17:1920x1080@30  18:1920x1080@25  19:1920x1080@24  20:1920x1080@24  21:1600x1200@60  22:1680x1050@60  23:1400x1050@60  24:1280x1024@75  25:1280x1024@60  26:1440x900@60  27:1280x960@60  28:1152x864@75  29:1280x720@60  30:1280x720@60  31:1280x720@60  32:1280x720@50  33:1024x768@75  34:1024x768@70  35:1024x768@60  36:832x624@75  37:800x600@75  38:800x600@72  39:800x600@60  40:800x600@56  41:720x576@50  42:720x480@60  43:720x480@60  44:640x480@75  45:640x480@73  46:640x480@67  47:640x480@60  48:640x480@60  49:640x480@60  50:720x400@70 
        Geometry: 1920,0 2560x1440
        Scale: 1
        Rotation: 1
        Overscan: 0
        Vrr: incapable
        RgbRange: Automatic
        HDR: enabled
                SDR brightness: 400 nits
                SDR gamut wideness: 0%
                Peak brightness: 400 nits
                Max average brightness: 400 nits
                Min brightness: 0.2929 nits             Brightness factor: 100%
        Wide Color Gamut: incapable
        ICC profile: none
        Color profile source: sRGB
Output: 2 HDMI-A-2
        enabled
        connected
        priority 3
        HDMI
        Modes:  0:1920x1200@60*!  1:1920x1080@60  2:1600x1200@60  3:1680x1050@60  4:1280x1024@75  5:1280x1024@72  6:1280x1024@60  7:1440x900@75  8:1440x900@60  9:1024x768@75  10:1024x768@70  11:1024x768@60  12:800x600@75  13:800x600@72  14:800x600@60  15:640x480@75  16:640x480@73  17:640x480@66  18:640x480@60  19:640x480@60  20:720x400@70 
        Geometry: 0,146 1920x1200
        Scale: 1
        Rotation: 1
        Overscan: 0
        Vrr: incapable
        RgbRange: Automatic
        HDR: incapable
        Wide Color Gamut: incapable
        ICC profile: none
        Color profile source: sRGB
Output: 3 DP-3
        enabled
        connected
        priority 2
        DisplayPort
        Modes:  0:1920x1080@60*!  1:1920x1080@75  2:1920x1080@60  3:1920x1080@60  4:1920x1080@60  5:1920x1080@60  6:1920x1080@50  7:1920x1080@50  8:1680x1050@60  9:1600x900@75  10:1600x900@60  11:1280x1024@75  12:1280x1024@60  13:1440x900@60  14:1152x864@75  15:1280x720@60  16:1280x720@60  17:1280x720@50  18:1024x768@75  19:1024x768@60  20:800x600@75  21:800x600@60  22:720x576@50  23:720x576@50  24:720x480@60  25:720x480@60  26:720x480@60  27:720x480@60  28:640x480@75  29:640x480@73  30:640x480@60  31:640x480@60  32:640x480@60  33:720x400@70 
        Geometry: 4480,266 1920x1080
        Scale: 1
        Rotation: 1
        Overscan: 0
        Vrr: incapable
        RgbRange: Automatic
        HDR: incapable
        Wide Color Gamut: incapable
        ICC profile: none
        Color profile source: sRGB

Dump all info in json format

kscreen-doctor --json

Set HDR enable for DP-1

kscreen-doctor output.DP-1.hdr.enable

Disable HDR for monitor DP-1

kscreen-doctor output.DP-1.hdr.disable

Disable the hdmi output, enable the laptop panel and set it to a specific mode

kscreen-doctor output.HDMI-2.disable output.eDP-1.mode.1 output.eDP-1.enable

Position the hdmi monitor on the right of the laptop panel

kscreen-doctor output.HDMI-2.position.1280,0 output.eDP-1.position.0,0

Set resolution mode

kscreen-doctor output.HDMI-2.mode.1920x1080@60

Set scale (note: fractional scaling is only supported on wayland)

kscreen-doctor output.HDMI-2.scale.2

Set rotation (possible values: none, left, right, inverted)

kscreen-doctor output.HDMI-2.rotation.left

Set HDR mode (possible values: enable, disable)

kscreen-doctor output.HDMI-2.hdr.enable

Set SDR brightness (possible values: 100-1000)

kscreen-doctor output.HDMI-2.sdr-brightness.300

Set wide color gamut mode (possible values: enable, disable)

kscreen-doctor output.HDMI-2.wcg.enable

Set ICC profile path

kscreen-doctor output.HDMI-2.iccprofile."/path/to/profile.icc"

Show runtime information: backends, logging, etc

kscreen-doctor --info