monitor-input

A command line tool to change display monitors' input sources with DDC/CI.

Supports Windows/Mac/Linux.

Also exposed as library.

Install

Please install Rust if you haven't done so.

From crates.io

cargo install monitor-input

From github

cargo install --git https://github.com/kojiishi/monitor-input-rs

From local checkout

cargo install --path .

As library

cargo add monitor-input

Please see the API documentation at docs.rs.

Usages

List display monitors

List all display monitors

You can get the list of displays by running the command without arguments.

monitor-input

The output should look like below.

0: Dell P2415Q
    Input Source: DisplayPort2
    Backend: winapi
1: Generic PnP Monitor
    Input Source: 0
    Backend: winapi
2: Dell U2723QE
    Input Source: DisplayPort1
    Backend: winapi
3: Dell P3223QE
    Input Source: Hdmi1
    Backend: winapi

Note that a display monitor may be listed twice. This happens when there are multiple ways to find display monitors, such as by the OS API and by the display driver APIs. The -b option can filter display monitors by the backend name.

Search display monitors by the name

You can search display monitors by specifying part of their names. The following example lists all display monitors whose name have "Dell", without changing their input sources.

monitor-input Dell

Search by the display monitor index

Searching by the display monitor index is also possible by using a number.

monitor-input 2 3

The example above lists the display monitors of index 2 and 3.

Set the input source

To set the input source of display monitors, append = and the input source name.

Set the input source by name

monitor-input U2723=dp1 P3223=hdmi1

When the name matches multiple display monitors, all display monitors are affected. The following example sets the input sources of all display monitors whose name have "Dell" to DisplayPort1.

monitor-input Dell=dp1

Set the input source by the display monitor index

The name can be a number, which specifies the display monitor index.

monitor-input 2=usbc2 3=usbc2

Vendor-specific input sources

The input source can be a number. This is useful when the display has non-standard, vendor-specific input sources.

monitor-input U2723=15 P3223=17

Toggle the input sources

You can toggle between two input sources. To do this, specify the input sources to toggle with a , (comma) as the separator.

monitor-input P3223=hdmi1,usbc2

The example above toggles the input source between Hdmi1 and UsbC2.

If the current input source is not in the list, the input source is set to the first input source in the list. In the example above, if the current input source is Hdmi1, it will be UsbC2. Otherwise it will be Hdmi1.

Toggle multiple display monitors

When toggling input sources of multiple display monitors at once, the first display monitor is used to determine the current input source.

monitor-input U2723=dp1,usbc2 P3223=hdmi1,usbc2

In this example, U2723 is the first display monitor. If its input source is DisplayPort1, its input source is changed to UsbC2 as explained before.

Because the first display monitor is changed to its second input source in the list, following display monitors will be changed to their second input sources in their lists. In this example, P3223 has hdmi1,usbc2. Its input source is set to the second entry, UsbC2 in this case.

This rule makes the input sources always consistent, even when the current input sources are not consistent across display monitors.

Cycle between more than two input sources

Cycling between more than two input sources is also possible, in the same way as toggling between two input sources.

monitor-input P3223=hdmi1,usbc2,dp1

If the current input source is Hdmi1, it will be UsbC2. If it's UsbC2, it will be DisplayPort1. Otherwise it will be Hdmi1.