Monitors

In a terminal, run:

icedos displays info

For the following outputs:

Gnome

logical monitor 0:
x: 0, y: 0, scale: 1, rotation: normal, primary: yes
associated physical monitors:
  DP-1 XXX MODEL SERIAL

DP-1 XXX MODEL SERIAL
  1920x1080@144 1920x1080 144* [x1.00+, x1.25, x1.51, x1.74, x2.00, x2.29, x2.50]

Hyprland

Monitor DP-1 (ID 0):
	1920x1080@144.00101 at 7280x200
	description: ASUSTek COMPUTER INC MG248 K4LMQS100269
	make: ASUSTek COMPUTER INC
	model: MG248
	serial: K4LMQS100269
	active workspace: 11 (11)
	special workspace: 0 ()
	reserved: 0 43 0 0
	scale: 1.00
	transform: 0
	focused: no
	dpmsStatus: 1
	vrr: false
	solitary: 0
	activelyTearing: false
	directScanoutTo: 0
	disabled: false
	currentFormat: XRGB8888
	mirrorOf: none
	availableModes: 1920x1080@60.00Hz 1920x1080@144.00Hz 1920x1080@119.98Hz 1920x1080@99.93Hz 1920x1080@84.91Hz 1920x1080@60.00Hz 1920x1080@59.94Hz 1920x1080@50.00Hz 1680x1050@59.95Hz 1280x1024@75.03Hz 1280x1024@60.02Hz 1440x900@59.89Hz 1280x960@60.00Hz 1280x800@59.81Hz 1152x864@75.00Hz 1280x720@60.00Hz 1280x720@60.00Hz 1280x720@59.94Hz 1280x720@50.00Hz 1024x768@75.03Hz 1024x768@70.07Hz 1024x768@60.00Hz 832x624@74.55Hz 800x600@75.00Hz 800x600@72.19Hz 800x600@60.32Hz 800x600@56.25Hz 720x576@50.00Hz 720x576@50.00Hz 720x480@60.00Hz 720x480@60.00Hz 720x480@59.94Hz 720x480@59.94Hz 640x480@75.00Hz 640x480@66.67Hz 640x480@60.00Hz 640x480@59.94Hz 640x480@59.94Hz 720x400@70.08Hz

You would do:

[[icedos.hardware.monitors]]
name = "DP-1"
resolution = "1920x1080"
refreshRate = 144
position = "0x0"
scaling = 1
rotation = 0
tenBit = false

To add another monitor, copy the code above, leave a newline space in-between, paste it, and edit it with the other monitor's settings.

Tip

If you have multiple monitors, the monitor you place first in the config.toml will be considered your "primary" monitor, whenever that concept is needed.

Options

name

Name of the physical connection adapter.

resolution

Your preferred resolution, in the format WIDTHxHEIGHT.

Tip

We strongly advise to use your monitor's native resolution.

refreshRate

Your preferred refresh rate, to a precision of 2 decimal points. If your monitor reports a fractional refresh rate, for example 164.9 or 164.90 or 164.900, you should put in 164.90 here.

position

The position of the monitor, relative to the top left of your primary monitor. If you have two 1920x1080 monitors and you want to have one in the center and one to the right, you would use 0x0 for the center one, and 1920x0 for the right one. Negative numbers can be used to position a monitor to the left, or the top of your primary one.

scaling

Controls the size of text and elements on the screen. This is the percentage of the zoom, divided by 100, so to achieve a 125% zoom, you would put in 1.25. If you're not sure what to use, leave it at 1, which is 100%.

rotation

Controls the rotation of the monitor in degrees. If you have a vertical monitor, you would set this to 90 or 270, otherwise leave it at 0.

tenBit

Enables 10-bit (30-bit) color support for the monitor.

Caution

Currently not supported by the vast majority of apps. Will prevent you from screensharing in Hyprland in most cases.