Last Updated: 3/12/2026

Monitors

Configure multiple displays, resolutions, refresh rates, scaling, and positioning in Hyprland. This guide covers everything from basic single-monitor setup to complex multi-monitor arrangements.

Monitor Configuration Syntax


monitor = NAME, RESOLUTION@RATE, POSITION, SCALE

NAME: Monitor identifier (e.g., DP-1, HDMI-A-1) or , for all
RESOLUTION@RATE: Resolution and refresh rate (e.g., 1920x1080@60)
POSITION: X,Y coordinates (e.g., 0x0, 1920x0)
SCALE: Scaling factor (e.g., 1, 1.5, 2)

Auto-Configuration

Let Hyprland auto-detect all monitors:


monitor =, preferred, auto, auto

This uses each monitor’s preferred resolution, auto-positions them, and applies no scaling.

Single Monitor Examples

Specific Resolution and Refresh Rate


monitor = DP-1, 1920x1080@60, 0x0, 1

4K Monitor with Scaling


monitor = DP-1, 3840x2160@60, 0x0, 2

Scaling factor 2 makes UI elements readable on high-DPI displays.

Ultrawide Monitor


monitor = DP-1, 3440x1440@144, 0x0, 1

Multi-Monitor Setup

Side-by-Side (Horizontal)


monitor = DP-1, 1920x1080@60, 0x0, 1
monitor = HDMI-A-1, 1920x1080@60, 1920x0, 1

Second monitor positioned to the right (X = 1920).

Stacked (Vertical)


monitor = DP-1, 1920x1080@60, 0x0, 1
monitor = HDMI-A-1, 1920x1080@60, 0x1080, 1

Second monitor positioned below (Y = 1080).

Mixed Resolutions


monitor = DP-1, 2560x1440@144, 0x0, 1         # Primary, left
monitor = HDMI-A-1, 1920x1080@60, 2560x0, 1   # Secondary, right

Finding Monitor Names

Use hyprctl to list connected monitors:


hyprctl monitors

Output shows monitor names, current resolution, position, and scale.

Refresh Rates

High Refresh Rate Gaming


monitor = DP-1, 2560x1440@165, 0x0, 1

Match Monitor Capability

Check your monitor’s specs and use the highest supported refresh rate:


monitor = DP-1, 1920x1080@144, 0x0, 1   # 144Hz
monitor = HDMI-A-1, 1920x1080@60, 1920x0, 1  # 60Hz

Scaling (HiDPI)

Integer Scaling


monitor = DP-1, 3840x2160@60, 0x0, 2  # 2x scaling

Best for sharpness. UI elements are exactly 2x size.

Fractional Scaling


monitor = DP-1, 2560x1440@60, 0x0, 1.5  # 1.5x scaling

May introduce slight blur but provides more flexibility.

No Scaling


monitor = DP-1, 1920x1080@60, 0x0, 1

Default for 1080p and lower resolutions.

Monitor Positioning

Calculate Positions

For side-by-side monitors, X position = sum of previous monitor widths:


# Monitor 1: 1920 wide, starts at X=0
monitor = DP-1, 1920x1080@60, 0x0, 1

# Monitor 2: starts at X=1920 (after Monitor 1)
monitor = HDMI-A-1, 1920x1080@60, 1920x0, 1

# Monitor 3: starts at X=3840 (after Monitor 1 + 2)
monitor = DP-2, 1920x1080@60, 3840x0, 1

Vertical Alignment

Align monitors by Y coordinate:


# Both monitors start at Y=0 (top-aligned)
monitor = DP-1, 1920x1080@60, 0x0, 1
monitor = HDMI-A-1, 2560x1440@60, 1920x0, 1

Center-Aligned Vertically


# Center smaller monitor vertically with larger one
monitor = DP-1, 2560x1440@60, 0x0, 1        # 1440 tall
monitor = HDMI-A-1, 1920x1080@60, 2560x180, 1  # Y=180 centers it

Calculation: (1440 - 1080) / 2 = 180

Disabling Monitors

Disable a specific monitor:


monitor = HDMI-A-1, disable

Monitor-Specific Workspaces

Assign default workspaces to monitors:


workspace = 1, monitor:DP-1, default:true
workspace = 2, monitor:HDMI-A-1, default:true

Querying Monitor Info

List All Monitors


hyprctl monitors

JSON Output


hyprctl monitors -j

Runtime Monitor Configuration

Test monitor settings without editing config:


hyprctl keyword monitor DP-1,1920x1080@144,0x0,1

Changes are temporary and reset on config reload.

Common Multi-Monitor Layouts

Dual Monitor (Primary + Secondary)


monitor = DP-1, 2560x1440@144, 0x0, 1      # Primary
monitor = HDMI-A-1, 1920x1080@60, 2560x0, 1  # Secondary

Triple Monitor (Eyefinity/Surround)


monitor = DP-1, 1920x1080@60, 0x0, 1       # Left
monitor = DP-2, 1920x1080@60, 1920x0, 1    # Center
monitor = DP-3, 1920x1080@60, 3840x0, 1    # Right

Laptop + External


monitor = eDP-1, 1920x1080@60, 0x0, 1      # Laptop screen
monitor = DP-1, 2560x1440@60, 1920x0, 1.5  # External monitor

Monitor Tips

List monitors first: Use hyprctl monitors to find exact names
Test with hyprctl: Try settings with hyprctl keyword before editing config
Use preferred when possible: monitor=,preferred,auto,auto works for most setups
Match refresh rates: Use monitor’s native refresh rate for best experience
Consider scaling: HiDPI monitors (>1440p) often need 1.5x or 2x scaling

What’s Next

Set up environment variables for your Wayland session.