Monitors
Omarchy assumes you're running on a 2x-capable retina-class display by default. This is what you need to get those nice, crisp programmer fonts. It's what almost all new premium laptops with high-resolution screens are optimized for. It's what you'd want to run on a 27" 5K Apple Studio Display/ProArt PA27JCV/Samsung S9/Kuycon G27P or 32" 6K Apple XDR/ProArt PA32QCV/Kuycon G32P.
But if you're not running a display with a PPI of 218 or above, you'll want to change the monitor settings. For example, if you have a 27" or 32" 4K, you can use fractional scaling by opening ~/.config/hypr/monitors.conf and switching to the recommendation for that combo:
env = GDK_SCALE,1.75
monitor=,preferred,auto,1.666667
If you're using a 1080p or 1440p display, you'll probably just want to use 1x scaling, so you can use:
env = GDK_SCALE,1
monitor=,preferred,auto,1
Changes to GDK_SCALE apply to applications started after the change. So make sure you quit the windows that you have that are oversized after the change (or close all windows with Ctrl + Alt + Del!).
You can also quickly cycle through the major monitor scaling ratios (1x, 1.6x, 2x, 3x) using Super + / to go higher and Super + Alt + / to go lower. If you have the default configuration, these changes will also persist past reboot.
Extending and mirroring laptop displays
When you connect an external screen to your laptop, the display is automatically extended. But you can change that to mirroring instead using Trigger > Hardware in the Omarchy menu or Super + Ctrl + Alt + Delete. This is especially helpful if that external screen is a projector, and you want to show something while working.
When you're extending, closing the lid on the laptop will automatically turn off the internal screen. Opening the lid will turn it back on. You can also control this manually using Trigger > Hardware in the Omarchy menu or Super + Ctrl + Delete.
Arranging multiple screens
Hyprland works great with multiple screens. Read more about how to lay them out in the Hyprland monitor documentation. You can bind specific workspaces to specific monitors as well.
You can also checkout Hyprmon, if you'd like a TUI to help you with the positioning of multiple screens.
Controlling brightness
Monitor brightness is controlled by the dedicated function keys for brightness up/down. If you hold down shift while pressing these, you'll go to maximum or minimum brightness.
Apple Displays
If you're using an Apple display, the regular keyboard brightness keys will also automatically work, if you're focused on the Apple display. This is done through the asdcontrol command.
Note that if you're using an Apple 6K XDR display, you may see a phantom screen in your hyprctl monitors listing. You can turn this off with something like monitor=DP-2,disable via Setup > Monitors.
On Intel machines, you should be connecting to Apple displays using a regular Thunderbolt cable. On other machines without Thunderbolt, you'll typically have to use a DP + USB-A -> USB-C cable to make it work.