TV over HDMI crops the edges of the desktop (overscan) and Wayland has no underscan setting
Verified end to end. hyprwm/Hyprland #277 ("Underscan/Overscan Support") is real and closed with state_reason not_planned, exactly as claimed. labwc #2049 ("Handling displays with overscan?") is open and its body contains the quoted "I have yet to find a way of doing it under Wayland" plus the panel/background-shrinking bodge the record describes. The reserved_area field is documented on the Monitors page in both forms the record shows (a single integer for all sides and a { top =, bottom =, left =, right = } table), and the quoted constraint "This stacks on top of the calculated reserved area (e.g. bars), but you may only use one of these rules per monitor in the config" is verbatim. The video=HDMI-A-1:1920x1080@60,margin_top=24,... form matches the Arch KMS page's documented comma-separated options, including the exact justification "typically to deal with overscan on TVs", and the record is appropriately honest that reports of it working under Wayland are thin. This record contains no hl.set. It uses only hl.monitor, which is correct Lua. The TV menu paths (Samsung Screen Fit, LG Just Scan, Sony Full Pixel, 1:1 Pixel Mapping / Dot by Dot) and the rename-the-input-to-PC trick are standard, correct vendor behaviour, and leading with them rather than with a compositor workaround is the right call. The closing warning against setting a smaller custom mode is sound advice that pre-empts the obvious wrong turn.
Symptom
Hooked the machine to a TV over HDMI and the top bar is half off-screen, the bottom of windows is cut away, and roughly 3-5% of every edge is missing. The TV is at the correct 1920x1080, hyprctl monitors looks right, and everything is fine on a normal monitor. There is no underscan or overscan slider anywhere in Hyprland or in the Omarchy display panel.
Cause
The TV is applying legacy CRT overscan: it crops the incoming frame and zooms the remainder to fill the panel. Nothing on the computer side is wrong. Under X11 you could compensate with the display's border/underscan property, but there is no Wayland protocol for output margins: hyprwm/Hyprland issue #277 ("Underscan/Overscan Support") is closed as *not planned*, and the same gap is documented for other compositors (labwc #2049: *"I have yet to find a way of doing it under Wayland"*, and the only workaround there is shrinking the panel and background, which still lets the pointer leave the visible area).
Fix
**1. Turn overscan off on the TV. This is the actual fix.** The setting is in the TV's picture menu and is named differently per brand:
- Samsung: *Picture → Picture Size Settings → Picture Size → **Screen Fit*** (and set *Fit to Screen* on)
- LG: *Picture → Aspect Ratio → **Just Scan*** (or *Original*)
- Sony: *Screen → Display Area → **Full Pixel***
- Panasonic / Philips / TCL: *Aspect → **1:1 Pixel Mapping*** / *Unscaled* / *Dot by Dot*
If the option is greyed out, rename the HDMI input to **PC** (Samsung/LG both unlock 1:1 mapping and 4:4:4 chroma only on an input labelled PC). On many sets this single change fixes it permanently.
**2. If the TV genuinely has no such setting, keep your UI out of the cropped strip.** Hyprland's reserved_area field reserves pixels that tiled windows will not occupy. It does not shrink the output, but it stops the bar and window content from landing in the cut-off band. In ~/.config/hypr/monitors.lua:
-- 1920x1080 TV cropping ~3% per side ≈ 30px vertical, 55px horizontal
hl.monitor({
output = "HDMI-A-1",
mode = "1920x1080@60",
position = "0x0",
scale = 1,
reserved_area = { top = 30, bottom = 30, left = 55, right = 55 },
})
A single integer applies to all four sides:
hl.monitor({ output = "HDMI-A-1", mode = "1920x1080@60", position = "0x0", scale = 1, reserved_area = 40 })
hyprctl reload
Measure the real crop first: put a window at each edge and count the missing pixels, or run a fullscreen image with a 1px border and see how much is gone. Note the wiki's constraint: *"This stacks on top of the calculated reserved area (e.g. bars), but you may only use one of these rules per monitor in the config."* So one reserved_area per monitor, and your bar's own reservation is added on top of it.
**3. Long shot, only if the above fails.** The kernel's modedb accepts margin options on the video= command line, documented on Arch's KMS page for exactly this case (*"typically to deal with overscan on TVs"*):
video=HDMI-A-1:1920x1080@60,margin_top=24,margin_bottom=24,margin_left=40,margin_right=40
Reports of this taking effect under a Wayland compositor are thin, so treat it as something to try, not something to rely on, and set the TV correctly if you possibly can.
**Do not** "fix" this by setting a smaller custom mode (e.g. 1776x1000 into a 1080p TV). The TV will upscale *and* still crop, giving you a soft picture with the edges still missing.
Verify
Open a terminal and maximise it: all four borders should be visible. hyprctl monitors -j | jq -r '.[] | "\(.name) \(.reserved)"' shows the reserved band on the TV output.